Skip to content
This repository was archived by the owner on Feb 24, 2024. It is now read-only.

Explain PostgREST REST style #249

Closed
steve-chavez opened this issue Aug 20, 2019 · 2 comments
Closed

Explain PostgREST REST style #249

steve-chavez opened this issue Aug 20, 2019 · 2 comments

Comments

@steve-chavez
Copy link
Member

steve-chavez commented Aug 20, 2019 •
edited
Loading

Related to #228.

We could have a dedicated page for our REST style. Explaining RFCs taken into account plus to Query Grammer.

Also I think this section on our docs http://postgrest.org/en/v5.2/#embracing-the-relational-model would fit better in that page.

In 1970 E. F. Codd criticized the then-dominant hierarchical model of databases in his article A Relational Model of Data for Large Shared Data Banks. Reading the article reveals a striking similarity between hierarchical databases and nested http routes. With PostgREST we attempt to use flexible filtering and embedding rather than nested routes.

For now I'll move that part out of the index page.
@steve-chavez steve-chavez added the references Technical reference. label Aug 20, 2019
@steve-chavez steve-chavez changed the title Add PostgREST REST style Explain PostgREST REST style Aug 20, 2019
steve-chavez added a commit to steve-chavez/postgrest-docs that referenced this issue Aug 20, 2019
@steve-chavez
Remove some elements of the index page
f383ad8 
As mentioned in PostgREST#249,
the embracing the relational model sectin would better fit in a
page about our REST style.

The shared improvements section no longer seems relevant since
we're already an established open source project.

Release notes are not removed but hidden from the index page.
steve-chavez added a commit that referenced this issue Aug 26, 2019
@steve-chavez
Remove some elements of the index page
8271885 
As mentioned in #249,
the embracing the relational model sectin would better fit in a
page about our REST style.

The shared improvements section no longer seems relevant since
we're already an established open source project.

Release notes are not removed but hidden from the index page.
@steve-chavez
Copy link
Member Author

As a first step we should document the query grammar plus the accepted headers(Prefer, Range, etc).

@steve-chavez steve-chavez removed the references Technical reference. label Aug 26, 2019
@steve-chavez
Copy link
Member Author

Refer to #228.

monacoremo pushed a commit to monacoremo/postgrest that referenced this issue Jul 17, 2021
@steve-chavez
Remove some elements of the index page
a7c0f89 
As mentioned in PostgREST/postgrest-docs#249,
the embracing the relational model sectin would better fit in a
page about our REST style.

The shared improvements section no longer seems relevant since
we're already an established open source project.

Release notes are not removed but hidden from the index page.
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Assignees
No one assigned
Labels
None yet
Milestone
No milestone
Development

No branches or pull requests
1 participant
@steve-chavez