Follow-up from "Add _links to package api"

The following discussion from !20820 (merged) should be addressed:

• @ggelatti started a discussion: (+1 comment)

  @pderichs Tks for the review! I'm moving this to maintainer review but please feel free to review my changes again! Tks a lot!

  @eread Could you review the doc changes?