postgrest-docs icon indicating copy to clipboard operation
postgrest-docs copied to clipboard

only use hint for disambiguation

Open steve-chavez opened this issue 3 years ago • 1 comments

Docs for https://github.com/PostgREST/postgrest/pull/2272

steve-chavez avatar May 06 '22 02:05 steve-chavez

https://postgrest--533.org.readthedocs.build/en/533/api.html#embedding-disambiguation

Seeing that now we prefer the hint disambiguation, we go from this:

GET /orders?select=name,billing_address(name) 

To this:

GET /orders?select=name,billing_address:addresses!billing_address(name) 

Which makes me realize renaming the FK doesn't really make things clearer now, so I think that part should be omitted.

We can mention that the FK name can be used in composite foreign keys cases and just put the autogenerated name.

steve-chavez avatar May 06 '22 02:05 steve-chavez

This tried to hide the "target disambiguation" feature - not good since it's still supported.

We should deprecate that form in a new release instead.

steve-chavez avatar Aug 26 '22 21:08 steve-chavez