PostgREST docs use the reStructuredText format, check this cheatsheet to get acquainted with it.

To build the docs locally, use nix:

  nix-shell

Once in the nix-shell you have the following commands available:

• postgrest-docs-build: Build the docs.
• postgrest-docs-serve: Build the docs and start a livereload server on http://localhost:5500.
• postgrest-docs-spellcheck: Run aspell.

This documentation is structured according to tutorials-howtos-topics-references. For more details on the rationale of this structure, see https://www.divio.com/blog/documentation.