-
Book Overview & Buying
-
Table Of Contents
-
Feedback & Rating

GraphQL Best Practices
By :

To begin, let’s start by explaining the purpose of our GraphQL schema.
The main purpose of a schema is for the schema consumer, or someone who will implement the schema, to understand a system’s functionalities without having to ask the schema creator additional questions. A well-documented schema can be compared to Plato’s cave allegory, where the idea is represented by the illuminated objects within the cave, while the actual object itself is represented by the shadows cast on the cave walls.
In this analogy, the documented schema serves as a representation of the underlying system, providing developers with a clear understanding of its structure, relationships, and capabilities. Just as the illuminated objects in the cave provide a conceptual understanding of the world outside, the documented schema provides developers with an abstract representation of the system.
Now we will use the schema created...