Kai Liao | e5e93bf | 2023-11-01 01:37:32 -0600 | [diff] [blame] | 1 | # CI/CD Documentation |
| 2 | |
Kai Liao | 60f3da6 | 2023-11-08 11:23:26 -0700 | [diff] [blame] | 3 | ```{toctree} |
| 4 | :glob: |
| 5 | |
| 6 | tools/* |
| 7 | ``` |
| 8 | |
Kai Liao | 8b1071a | 2023-11-27 16:34:52 -0600 | [diff] [blame] | 9 | ## Project Information |
| 10 | |
Kai Liao | 692496c | 2023-11-28 08:57:40 -0600 | [diff] [blame] | 11 | - [Build Guide](../guides/BUILDING.md) |
Kai Liao | 8b1071a | 2023-11-27 16:34:52 -0600 | [diff] [blame] | 12 | - Sphinx documentation framework |
| 13 | - New directories and individual files must be added to the |
| 14 | [tree](https://github.com/project-chip/connectedhomeip/blob/master/docs/index.md) |
| 15 | - New files under directories must be added to the tree in the index file; |
| 16 | see above. Glob and regular expressions may be used to include all |
Kai Liao | 692496c | 2023-11-28 08:57:40 -0600 | [diff] [blame] | 17 | - The |
| 18 | [documentation page](https://project-chip.github.io/connectedhomeip-doc/) |
| 19 | is the end product |
| 20 | - Links can be relative; links ending in ".md" in the code will be |
| 21 | reflected as ".html" on that page |
Kai Liao | 8b1071a | 2023-11-27 16:34:52 -0600 | [diff] [blame] | 22 | - Pull Requests |
| 23 | - Built in style and spelling checks must be satisfied |
| 24 | - Larger changes should go through an approval process; reviewers are |
| 25 | automatically added |
| 26 | - Smaller specific changes like ones to this file may be expedited with |
| 27 | the "fast track" label |
| 28 | |
| 29 | Work In Progress |
| 30 | |
Kai Liao | 1a195c7 | 2023-12-05 14:08:55 -0800 | [diff] [blame] | 31 | ## Tasks |
Kai Liao | e5e93bf | 2023-11-01 01:37:32 -0600 | [diff] [blame] | 32 | |
Kai Liao | 1a195c7 | 2023-12-05 14:08:55 -0800 | [diff] [blame] | 33 | - [Issues List](https://github.com/project-chip/connectedhomeip/labels/CI%2FCD%20improvements) |
Kai Liao | e5e93bf | 2023-11-01 01:37:32 -0600 | [diff] [blame] | 34 | |
| 35 | ## Tools |
| 36 | |
Kai Liao | 692496c | 2023-11-28 08:57:40 -0600 | [diff] [blame] | 37 | - [Daily Fail Summary](tools/daily_fail_summary.md) |
Kai Liao | 657fa28 | 2024-03-26 07:17:16 -0600 | [diff] [blame] | 38 | - Spellcheck |
| 39 | - Uses |
| 40 | [`rojopolis`/spellcheck-github-actions](https://github.com/marketplace/actions/github-spellcheck-action#configuration), |
| 41 | a PySpelling-based spellchecker |
| 42 | - This tool utilizes the definitions in .spellcheck.yml and |
| 43 | .github/`.wordlist.txt` to check all documentation files. |
| 44 | .spellcheck.yml defines the settings while `.wordlist.txt` is a |
| 45 | dictionary of words to skip checking (brand names, technical jargon, |
| 46 | acronyms) |
Kai Liao | edfc199 | 2023-11-01 18:39:12 -0600 | [diff] [blame] | 47 | |
Kai Liao | 99f61c2 | 2023-11-06 12:55:34 -0700 | [diff] [blame] | 48 | ## General Improvement Ideas |