The wording in the “Content Negotiation” section of the documentation seems vague to me. I feel that I know what it means, but I want to clarify and if anyone agrees that it’s vague I may open a pull request.
Under “Client Responsibilities” it reads:
Clients MUST send all JSON API data in request documents with the header Content-Type: application/vnd.api+json without any media type parameters.
This could mean two distinct things. The first is that it could mean that all requests MUST have the Content-Type application/vnd.api+json and also MUST NOT have media type parameters. The other meaning is that any request THAT HAVE the Content-Type application/vnd.api+json MUST ALSO NOT HAVE media type parameters.
I assume it means the first, but it is very easy to intemperate the meaning as the second. There are a few places where unclear statements such as this are made.
Am I correct in the interpretation? Should it be rewritten to be more clear?