Problem/Motivation
There is no human readable documentation for a REST API.
Proposed resolution
Provide documentation for link relations. For example, see http://haltalk.herokuapp.com/rels/posts. When a site enables HAL, this documentation can be used to guide users through the API... see HAL Browser for HAL Talk.