Add sections for different upstream annotation formats

[Ranjandas]

Description

Add subsections for different upstream annotation formats for better readability and also to make it easier to link from other documentation (eg: Learn Guide on cluster peering)

NOTE: The GitHub markdown preview seems to be different from the local preview

PR Checklist

• [ ] updated test coverage
• [x] external-facing docs updated
• [x] not a security concern

[david-yu]

Hi @Ranjandas I like where you are headed here. Perhaps we need to re-org the annotations to make it easier to link to per use case? Is that the intent of the PR?

[Ranjandas]

@david-yu, Yes, I planned to categorize/re-org the annotations but ended up only doing the upstream annotations. The main reason for cutting down the effort was that my local previews of the new website were extremely slow, and in addition, I wasn't sure which category some of them should fall into.

I can work on a draft PR with full re-org and send it for review if you are happy with the plan.

[github-actions[bot]]

This pull request has been automatically flagged for inactivity because it has not been acted upon in the last 60 days. It will be closed if no new activity occurs in the next 30 days. Please feel free to re-open to resurrect the change if you feel this has happened by mistake. Thank you for your contributions.

[github-actions[bot]]

Closing due to inactivity. If you feel this was a mistake or you wish to re-open at any time in the future, please leave a comment and it will be re-surfaced for the maintainers to review.