Guide to documenting Q-CTRL projects
Q-CTRL projects have two types of documentation:
Contributor documentation is found in the
.github/README.md file and contains only the necessary information for a developer to get started contributing to the project. Q-CTRL follows the standard specified in the Formatting your README GitHub guide. The
.github/README.md file in the Q-CTRL Template repository contains the prescribed structure and instructions on how to apply this standard.
User documentation is found in two places:
- The Q-CTRL Documentation website.
README.md file in the root of the repository differs from the
.github/README.md file above inasmuch as it is used by repositories whose code is published as a software package. This
README.md file is used by the hosted package manager to display information about the software package on the packages home page.
Below are examples of the
README.md file being used to populate package home pages.
The Q-CTRL Documentation website
Any means by which a user accesses the platform is supported by user documentation with the aim of making it easy and intuitive to use the software.
User documentation follows the Diátaxis Framework.