That's exactly the point of this diagram - make audience familiar with the API's domain before throwing them into useful detail of specs like Swagger.

You brought another very good point about being able to hyperlink directly into Swagger, something we have been talking about a lot recently. Unfortunately, we have not come across a tool that does this satisfactorily.