The purpose of this repository is to have a template from which to create complete and usable documentation.
The simplest way of using this repository is to copy the source code of TEMPLATE.md
(found here) to wherever you would like the documentation to appear. Fill in the relevant placeholders and save.
Github doesn't generate Tables of Contents natively, unlike other flavors of Markdown. Since we want to have a Table of Contents for ease of navigation and readability, we will have to generate one. To do so, please follow the instructions here.
For any code that needs to be included (unless it is a single-word command), please do not use inline code
. Instead, to aid in readability, please use
code blocks like this
For any file and folder names (and one-word commands), use code quoting
so the delineation is obvious.
If you have questions regarding best practices for documentation, here are some resources to look into:
- The Documentation Compendium
- Github Documentation Guide
- feel free to add any more resources here that you feel would be