|
Right now all the model information about entities, such as fields and such are kept in the various endpoint documents. This isn't as accessible as I'd like it to be for the purposes of PQL. We should take the model documentation out of the endpoints, and instead extend entities.markdown/html to include all model information for all entities. Endpoint docs can then reference those pages.
Other ideas
-
maybe we squash the endpoints into 1 doc perhaps, now the model information is on its own?
-
the model is going to be fairly repetitive, we should consider using the Liquid templating that is provided on the docs website, to format information on the model from data. The data itself can be stored in the front-matter (the little bit of YAML at the top of each file) of the markdown for now, until we can extract it from the engine automatically perhaps.
-
in the future obviously, it would be lovely to generate this model documentation automatically from the query engines information about the model.
|