This script will generate the following documentation files:
sig-*/README.md
wg-*/README.md
sig-list.md
Based off the sigs.yaml
metadata file.
To (re)build documentation for all the SIGs, run these commands:
make all
To build docs for one SIG, run these commands:
make SIG=sig-apps gen-doc
make SIG=sig-testing gen-doc
make WG=resource-management gen-doc
where the SIG
or WG
var refers to the directory being built.
If your SIG or WG wishes to add custom content, you can do so by placing it within the following code comments:
<!-- BEGIN CUSTOM CONTENT -->
<!-- END CUSTOM CONTENT -->
Anything inside these code comments are saved by the generator and appended to newly generated content. Updating any content outside this block, however, will be overwritten the next time the generator runs.
An example might be:
<!-- BEGIN CUSTOM CONTENT -->
## Upcoming SIG goals
- Do this
- Do that
<!-- END CUSTOM CONTENT -->