You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
1.Integrate a natural language linter like Vale into the CNB documentation workflow.
2.Implement spell check and grammar rules to ensure consistent language usage across all documentation pages.
3.Define style libraries and extension points within the linter to enforce project-specific writing guidelines and conventions.
4.Configure the linter to check for common writing errors, improve readability, and suggest enhancements for technical content.
5.Provide guidelines and documentation on how contributors can use the linter during the documentation writing and review process.
What questions should this documentation answer?
Who is the target audience for this documentation?
App Developer
Buildpack Author
Operator
Other:
Additional Information
Benefits:
Improved documentation quality with consistent spelling, grammar, and style.
Enhanced readability and understanding of technical content for users and contributors.
Facilitates collaboration by establishing clear writing standards and guidelines.
Supports the long-term maintainability and scalability of the CNB documentation.
The text was updated successfully, but these errors were encountered:
Summary
The Vale Linter (natural language linter) implements spell check and other basic rules.
_https://github.com/errata-ai/vale
Proposed Changes:
1.Integrate a natural language linter like Vale into the CNB documentation workflow.
2.Implement spell check and grammar rules to ensure consistent language usage across all documentation pages.
3.Define style libraries and extension points within the linter to enforce project-specific writing guidelines and conventions.
4.Configure the linter to check for common writing errors, improve readability, and suggest enhancements for technical content.
5.Provide guidelines and documentation on how contributors can use the linter during the documentation writing and review process.
What questions should this documentation answer?
Who is the target audience for this documentation?
Additional Information
Benefits:
Improved documentation quality with consistent spelling, grammar, and style.
Enhanced readability and understanding of technical content for users and contributors.
Facilitates collaboration by establishing clear writing standards and guidelines.
Supports the long-term maintainability and scalability of the CNB documentation.
The text was updated successfully, but these errors were encountered: