This was a great read but one thing I'd like to see is some examples that, for the most part, follow these conventions. Any suggestions that I can dig through as a reference point?
I plan to eventually incorporate guidelines on writing good openapi specifications, and general design patterns for API.
Very much agree with most of the points in the article, such as returning objects over flat array's, supporting partial updates via PATCH.
I'm less convinced by exclusion of PUT (sometimes a client generated id / idempotent create is useful), and ability to filter collections on all fields (sounds inefficient).
Look forward to returning to this when some of the to-dos have been filled out