Document (& fix) HateoasBuilder
[doc] be more verbose