Adds a Data Modeling section that provides simple user-facing language, allowing them to see a connection between their preferred data source + Hasura DDN concepts. Ideally, this is the next section a user will encounter when taking their first steps after the quickstart/getting-started guides.
The language is intentionally direct and concise. As an example, each page in the new directory has a sidebar-level explanation of what a metadata object does. Further, within the pages, we provide users with a clear idea of when / why they'll want to perform certain operations and give them connector-specific implementations. Yes, there will be duplication here as some operations are the same across connectors, but we want them to feel "at home" with their connector in our docs.
As of opening this PR, I've stubbed out all the necessary pages for this directory. Additionally, there's a near-complete set of Postgres docs for the Models page. This will need to be completed and the template followed for the other pages and connectors. Similar to #731, contributors should:
Create a new branch off rob/docs/add-data-modeling-concepts
Fill in their connector's respective examples across all pages
Description π
Adds a Data Modeling section that provides simple user-facing language, allowing them to see a connection between their preferred data source + Hasura DDN concepts. Ideally, this is the next section a user will encounter when taking their first steps after the quickstart/getting-started guides.
The language is intentionally direct and concise. As an example, each page in the new directory has a sidebar-level explanation of what a metadata object does. Further, within the pages, we provide users with a clear idea of when / why they'll want to perform certain operations and give them connector-specific implementations. Yes, there will be duplication here as some operations are the same across connectors, but we want them to feel "at home" with their connector in our docs.
TODO
Quick Links π
New data modeling section
Instructions for contributors
As of opening this PR, I've stubbed out all the necessary pages for this directory. Additionally, there's a near-complete set of Postgres docs for the
Models
page. This will need to be completed and the template followed for the other pages and connectors. Similar to #731, contributors should:rob/docs/add-data-modeling-concepts