Comment by dragonwriter

> How does this miss the point of REST?

Because if it didn't, the full API description language would be:

  api-root: <url>

Or, for a pedantically detailed version:

  api-root: <url>
  media-types: 
      - <media-type>
      - <media-type>