Update documentation to be compliant with latest development

The documentation haven't been update when we removed the top-level `links`. I've also rewrite the scenario to include examples of `has_many` and `belongs_to` relationships.