add HATEOAS note