...
We've decided that it makes the most sense to use the central Atlassian wiki. We would require that every official spec have a Wiki page with some required fields:
- Why would someone choose this tool?
- What are the primary features?
- A short (5-7 minute) demo of the key features
- NDS projects using this technology
- Related links.
The "info" link in the service spec will take users to the wiki page.
Analysis
Use a Readme
- Require every user to include a readme with their service PR following a certain template
...