Yes, that's the key. If the media types are documented (like how browsers and developers understand HTML forms) then you don't need to document every single cor

Yes, that's the key. If the media types are documented (like how browsers and developers understand HTML forms) then you don't need to document every single corner of the API. You can offer a good definition of the media types, and let the resources and links do the rest.