CI Pipeline for better documentation
Most projects start with spikes, where developers and analysts produce lots of documentation.
Sometimes, these documents don't have a standard and each team member writes them accordingly with their preference. Add to that the time a reviewer will spend confirming grammar, searching for typos or non-inclusive language.
This pipeline helps address that!
The pipeline uses the following
- markdownlint: add standardization using rules
- markdown-link-check: check the links in the documentation and report broken ones
- write-good: linter for English prose
We have been using this pipeline for more than one year in different engagements and always received great feedback from the customers!
How does it work
To start using this pipeline:
- Download the files from this repository
- Unzip the folders and files to your repository root if the repository is empty
- if it's not brand new, copy the files and make the required adjustments:
.azdoso it matches your repository standard - check
package.jsonso you don't overwrite one you already have in the process. Also update the file if you changed the name of the
- Create the pipeline in Azure DevOps or GitHub
Markdown Code Reviews in the Code With Engineering Playbook
Last update: October 18, 2021