Guideline for RestAPI Design and pattern
Description
In the devdocs is a RestAPI description which only describes the FOS elements. The OpenAPI which the applications like web Client or Android iOS App can use is not describes. And the structure and Design pattern for the API is not describes.
Impact
User of the RestAPI can see more details. The developer can reuse exieting structures or patterns. This helps to provide a consistency API to the user.
Proposal
Extend the devdocs so that all know the design patterns.