Using writing tools to improve documentation quality
Quality of the Red Hat Advanced Cluster Management for Kubernetes (RHACM) documentation is vital for customer success. Some items of quality that we verify are functionality of links and spelling. Maintain the quality of the RHACM docs by using the following tools:
Check my links tool
Download the Google Chrome web extension Check My Links or Firefox add-on Broken Link Checker (Firefox).
client9/misspell tool
Complete the following steps to run the spellcheck tool:
- Install the
client9/misspell
locally by running the following command:curl -L -o ./install-misspell.sh https://git.io/misspell sh ./install-misspell.sh
- Run the following command in the folder where the
misspell
tool is installed:misspell -w -locale US rhacm-docs 2.9_stage
Note: The results are populated in your terminal automatically.
- Create a new branch before committing the changes.
- Create a pull request and verify the updates.