Description of the product’s intent / proposition goes here. We also want to capture things such as:
This top-level document doesn’t need to subsume every other document, but provide a launchpad from which other documents can be accessed. Since Product already capture persona information on Product Central, just link off from there.
This is the atlas-level map, where all continents and major countries are visible, and the laws of physics governing the world are spelled out.
Important words to do with this product. This might include references to words of equivalence, or terms that have been deprecated but are still in use.
Description of where one goes to get the source code for the product. A list of repositories if it’s relevant.
One or more list of:
Description of the process of creating the product. Include details around the build tooling, linking off to other
product.mds if there is an involved build system to reference.
If there are test tools that are important at product level, list and provide details of them here.
A list of components that make up this product, and the reference to their
component.md file. A component is a technological division, rather than necessarily a user-facing module, although they are in most cases likely to be one and the same.
A list of owners of various areas around the product, this might include listing:
A list and details of versions of the product, and any external references that are important to that particular version.
Anything else that we haven’t already got a list of goes here. This might include historic references to why this product exists, or cheat sheets on the language used. In most cases, I would expect this section to be empty.
A chronological list of decisions that have been made around the product, capturing key information and the context of the decision at the time. Useful for reference later on.