layout |
---|
default |
“Best practice templates and writing instructions for documenting open source software.”
We want to help open source projects be more effective by helping them lift the quality of their documentation.
We are creating processes, templates, and guides covering the numerous aspects of writing good documentation. We describe our reasoning, referencing research where available, to help writers decide when they should deviate from suggestions.
Every project deserves a minimum level of Good Docs, but it can be really hard to know where to start or what to write. Our open source suite of templates will help you create a baseline set of documentation.
Our key target audiences are:
- Software developers who want to use guides and templates to create documentation for their project.
- Technical writers setting up a documentation framework, who want to make use of established templates and processes, customizing where appropriate to align with the project's goals.
- Project owners who need to balance project priorities, and want to understand the return-on-effort associated with different documentation strategies.
- The latest development version of templates are available from the github main branch.
- The 0.1 alpha straw-man release of templates was released at the 2019 Write The Docs - Australia conference.
Not quite ready to jump into the templates yet? Prepare yourself for writing great documentation by spending some time in the shoes of your readers, with the Information Architecture Guide
The following initiatives are being worked on in 2020:
- Templates
- Cross-domain management of glossaries
- How-to for style guides
- Base template (template for templates)
And possibly:
- Docs audit framework
- Implementing a style guide in tools
- Integrate doc tool chains
- Doc format conversion tools