Files
postgrest/docs
steve-chavezandLaurence Isla 490d1dc5d3 add: config to emit warning for legacy target names
Adds the `url_use_legacy_target_names` config.

Enabled (default):
* It allows using the resource name in filters,
  orders or limits when it has an alias, e.g.
  `table?select=alias:target(*)&target.id=eq.1`
* Logs a WARNING with a hint to use the alias
* Returns a Warning header in the response

Disabled:
* It returns an error, only the alias is allowed
* No warnings returned

This feature is deprecated
2026-07-11 02:15:07 +00:00
..
2025-03-28 09:22:34 +00:00
2026-03-10 16:41:42 +00:00
2026-03-03 22:02:18 -05:00
2026-04-27 08:29:41 +00:00

PostgREST documentation https://postgrest.org/

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

To build the docs locally, see the Nix development readme.

Documentation structure

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.

Translating

To create .po files for translation into a new language pass the language code as the first argument to postgrest-docs-build.

Example to add German/de:

postgrest-docs-build de

The livereload server also supports a language/locale argument to show the translated docs during translation:

postgrest-docs-serve de

Spellcheck is currently only available for the default language.