David BaynardandGitHub 018427e2b6 Note content-type for singular objects (#639)
* Clarify vnd.pgrst.object+json is also Content-Type

The previous docs explained how the `Accept` header could be set to
`application/vnd.pgrst.object+json`. This change indicates the resulting
response `Content-Type` begins likewise.

While robust clients will correctly identify that
`application/vnd.pgrst.object+json` data are json, many others which
naively check the `Content-Type` is `application/json` will fail to
recognize what should be a valid `Content-Type`.
2023-06-09 15:23:04 -05:00
2023-05-11 01:37:50 -03:00
2022-11-02 12:23:35 -05:00
2021-04-06 15:43:32 +02: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, 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.

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.

Languages
Haskell 67.3%
PLpgSQL 21.5%
Python 6.7%
Nix 4.3%
Shell 0.2%