Once you've submitted your content as a pull request (PR) on GitHub, the review process starts. Make sure that you invite reviewers so the new content is peer-reviewed by both your subject matter experts and (technical) writers.
Creating a pull request triggers the GitHub Actions integration, automatically deploying your content to a preview environment. This preview environment allows you and your peer reviewers to check how your changes will appear on your site, including graphical elements, formatting, and overall structure. This environment serves as a controlled testing ground for your new content and it provides a comprehensive preview of your content's final appearance. The preview instance automatically rebuilds with each further commit you make.
Language linters can be integrated and be part of the CI toolchain. Using linters in your writing workflow can be highly beneficial as they promote consistency in writing style pointing out typos, errors, and non-inclusive language and enhancing overall readability of your documentation.
For example, EkLine conducts checks based on predefined style guide rules, assessing plain language usage, analyzing content quality and consistency, and ensuring compliance with documentation standards.
Similar to human peer-reviewers, Ekline provides feedback on your pull request (PR) and leaves comments instead of automatically forcing changes, so everything stays under the control of the author. It identifies issues such as spelling errors, passive voice, and the use of weasel words. This feedback is valuable for maintaining the overall quality and consistency of your content, enhancing readability and using plain English. You can incorporate these suggestions into your content as you continue to iterate and improve it.
Reviewers access the PR and examine the changes you've made. They can use GitHub's built-in tools to view the differences between the previous version and your proposed changes, and they can use the preview instance to check how the changes will be displayed on the live site.
Reviewers can leave comments on specific lines or sections of the documentation, pointing out any issues, suggesting improvements, or asking questions. Discussions can happen within the comments, allowing for clarification and further collaboration.