Upgrade documentation for the `hal` and `links` endpoints as they are
not using the root anymore.

Closes gh-3621