Add inclusivity/accessibility/user-friendliness tip into `Contributing`

Signed-off-by: Egor Savkin <es@m-labs.hk>
This commit is contained in:
Egor Savkin 2024-05-16 13:04:05 +08:00
parent 32567574fc
commit c1b1af0b0e
1 changed files with 6 additions and 4 deletions

View File

@ -33,7 +33,9 @@ Tips for adding hardware instructions:
for images with transparent background) for images with transparent background)
3. Add link to the new chapter to the `src/SUMMARY.md` 3. Add link to the new chapter to the `src/SUMMARY.md`
4. Do not forget to tell about all hidden/non-obvious obstacles and pitfalls 4. Do not forget to tell about all hidden/non-obvious obstacles and pitfalls
5. Add testing steps, even the "obvious" ones 5. Avoid using uncommon, complex, or hard-to-understand words, phrases, or grammar (e.g., ❌constituent -> ✔component).
6. Add JSON sample if needed Keep in mind that these guides may be used by people with different backgrounds and levels of English proficiency.
7. Add hardware setup (e.g. pins, switches) steps if needed 6. Add testing steps, even the "obvious" ones
8. View changed and added pages with `mdbook build` (see building instructions above) 7. Add JSON sample if needed
8. Add hardware setup (e.g. pins, switches) steps if needed
9. View changed and added pages with `mdbook build` (see building instructions above)