50bdd9610e
### Description This small PR develops a bit the existing documentation about remote joins. It adds a new section that details where each piece of the feature is located, and adds two paragraphs detailing some of the implementation details of the execution. PR-URL: https://github.com/hasura/graphql-engine-mono/pull/6505 GitOrigin-RevId: 6edd5459e4081cc6c9a80fdc92c2d479dedb2be9 |
||
|---|---|---|
| .. | ||
| data-sources | ||
| deep-dives | ||
| glossary.md | ||
| overview.md | ||
| README.md | ||
| tips.md | ||
Server engineering documentation
This page documents the structure and the internal architecture of the GraphQL Engine Server. To get started, you can read the overview. We also maintain a glossary of all the terms we use throughout the code and the documentation.
You can also get started with a list of tips and tricks.
Haddock documentation
You can browse the engine's haddock documentation for the stable branch, main branch, and every previous version release since v2.2.0.
Architecture deep-dive
- how to understand our GraphQL schema
- how to perform database migrations
- how the execution of remote joins works
Backend-specific documentation
Notes
In our Haskell codebase, we use GHC-style
notes for long-form
comments detailing a specific aspect of the codebase. We gather all of them, as
of the main branch, in the notes subfolder.
Updating this documentation
All markdown files in this folder are either copied verbatim from
server/documentation
or generated as part of our CI; do not open a PR to modify files in
the gh-pages branch, and instead modify their source directly. Notes
are extracted using the scripts/extract-nodes bash script. The
haddock documentation is generated by running cabal haddock --haddock-internal --haddock-options="--ignore-all-exports".