blob: c2bfc51db6af9eec9be2a55090221f73df965727 [file] [log] [blame] [view]
# CI/CD Documentation
```{toctree}
:glob:
tools/*
```
## Project Information
- [Build Guide](../guides/BUILDING.md)
- Sphinx documentation framework
- New directories and individual files must be added to the
[tree](https://github.com/project-chip/connectedhomeip/blob/master/docs/index.md)
- New files under directories must be added to the tree in the index file;
see above. Glob and regular expressions may be used to include all
- The
[documentation page](https://project-chip.github.io/connectedhomeip-doc/)
is the end product
- Links can be relative; links ending in ".md" in the code will be
reflected as ".html" on that page
- Pull Requests
- Built in style and spelling checks must be satisfied
- Larger changes should go through an approval process; reviewers are
automatically added
- Smaller specific changes like ones to this file may be expedited with
the "fast track" label
Work In Progress
## Tasks
- [Issues List](https://github.com/project-chip/connectedhomeip/labels/CI%2FCD%20improvements)
## Tools
- [Daily Fail Summary](tools/daily_fail_summary.md)
- Spellcheck
- Uses
[`rojopolis`/spellcheck-github-actions](https://github.com/marketplace/actions/github-spellcheck-action#configuration),
a PySpelling-based spellchecker
- This tool utilizes the definitions in .spellcheck.yml and
.github/`.wordlist.txt` to check all documentation files.
.spellcheck.yml defines the settings while `.wordlist.txt` is a
dictionary of words to skip checking (brand names, technical jargon,
acronyms)
## General Improvement Ideas