Docs update to reflect new HATEOAS links.

HATEOAS links are now relative to API root so docs needed an update too.

Addresses #398 #401.