blob: c2bfc51db6af9eec9be2a55090221f73df965727 [file] [log] [blame] [view]
Kai Liaoe5e93bf2023-11-01 01:37:32 -06001# CI/CD Documentation
2
Kai Liao60f3da62023-11-08 11:23:26 -07003```{toctree}
4:glob:
5
6tools/*
7```
8
Kai Liao8b1071a2023-11-27 16:34:52 -06009## Project Information
10
Kai Liao692496c2023-11-28 08:57:40 -060011- [Build Guide](../guides/BUILDING.md)
Kai Liao8b1071a2023-11-27 16:34:52 -060012- 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 Liao692496c2023-11-28 08:57:40 -060017 - 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 Liao8b1071a2023-11-27 16:34:52 -060022- 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
29Work In Progress
30
Kai Liao1a195c72023-12-05 14:08:55 -080031## Tasks
Kai Liaoe5e93bf2023-11-01 01:37:32 -060032
Kai Liao1a195c72023-12-05 14:08:55 -080033- [Issues List](https://github.com/project-chip/connectedhomeip/labels/CI%2FCD%20improvements)
Kai Liaoe5e93bf2023-11-01 01:37:32 -060034
35## Tools
36
Kai Liao692496c2023-11-28 08:57:40 -060037- [Daily Fail Summary](tools/daily_fail_summary.md)
Kai Liao657fa282024-03-26 07:17:16 -060038- 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 Liaoedfc1992023-11-01 18:39:12 -060047
Kai Liao99f61c22023-11-06 12:55:34 -070048## General Improvement Ideas