Magnolia 5.6 (On the headless cloud maybe even earlier) brings REST 2.0
There is a bunch of pages which must be updated, adapted, rewritten ... let's see.

All JIRA tickets of MGNLREST#2.0

Possible candidates for doc pages which must be updated:

• https://documentation.magnolia-cms.com/display/DOCS/REST+module
• https://documentation.magnolia-cms.com/display/DOCS/REST+API
• https://documentation.magnolia-cms.com/display/DOCS/My+first+REST+request
• https://documentation.magnolia-cms.com/display/DOCS/How+to+get+content+as+JSON+-+an+overview
• https://documentation.magnolia-cms.com/display/DOCS/How+to+create+a+custom+Java+based+REST+endpoint
• https://documentation.magnolia-cms.com/display/DOCS/Accessing+content+on+the+client+side

Some pages will need only minor updates, some changes will be bigger.
It is also possible that we will keep ref. pages for the "default endpoint(s)" for both versions 1 and 2, since I expect that both will still be available.

Here is a concept about how to tackle this ticket: Update docs for REST