search

hasura / graphql-engine

Blazing fast, instant realtime GraphQL APIs on your DB with fine grained access control, also trigger webhooks on database events.
https://hasura.io
Apache License 2.0
31.18k stars 2.76k forks source link

Docs: Model reference documentation should talk about "why / what is a model" #10329

Open coco98 opened 4 months ago

coco98 commented 4 months ago

On the model documentation https://hasura.io/docs/3.0/supergraph-modeling/models shouldn't we mention why we add models?

For example:

Models create a standard API with a, b, c features and compose well with each other. here's an example of a model actually shows up in your API.

And then we go into the reference documentation?

seanparkross commented 4 months ago

https://github.com/hasura/v3-docs/pull/501