Standardize documentation approach for package authors

**Describe the problem/challenge you have**

Package authors need a means of providing shipping documentation alongside their package. Ideally, the documentation source could live alongside the package itself such that it could be consumed and rendered in a variety of location. By providing specification or standards for package docs, we could ensure any package could be supported in a variety of catalogs, docs sites, tooling etc.

Consider the following example:


In the above, docs are stored inside the repo bundle. This could also enable docs to be rendered in a variety of ways, including air-gapped environments.

---
Vote on this request

This is an invitation to the community to vote on issues, to help us prioritize our backlog. Use the "smiley face" up to the right of this comment to vote.

👍 "I would like to see this addressed as soon as possible"
👎 "There are other more important things to focus on right now"

We are also happy to receive and review Pull Requests if you want to help working on this issue.