-
Notifications
You must be signed in to change notification settings - Fork 47
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Do extra docs validation; explicitly disallow semantic markup in docs #165
Conversation
Codecov Report
@@ Coverage Diff @@
## main #165 +/- ##
=======================================
Coverage 84.57% 84.57%
=======================================
Files 32 32
Lines 3850 3850
Branches 710 710
=======================================
Hits 3256 3256
Misses 456 456
Partials 138 138
Flags with carried forward coverage won't be shown. Click here to find out more. Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here. |
This reverts commit 445c56e.
Backport to stable-1: 💚 backport PR created✅ Backport PR branch: Backported as #167 🤖 @patchback |
…#165) * Do extra docs validation. Explicitly disallow semantic markup in docs. * Forgot to add new requirement. * Improve test. * TEMP - make CI fail. * Remove unnecessary import. * Make sure ANSIBLE_COLLECTIONS_PATH is set. * Revert "TEMP - make CI fail." This reverts commit 445c56e. * Make sure sanity tests from older Ansible versions don't complain. (cherry picked from commit dd1e48c)
…#165) (#167) * Do extra docs validation. Explicitly disallow semantic markup in docs. * Forgot to add new requirement. * Improve test. * TEMP - make CI fail. * Remove unnecessary import. * Make sure ANSIBLE_COLLECTIONS_PATH is set. * Revert "TEMP - make CI fail." This reverts commit 445c56e. * Make sure sanity tests from older Ansible versions don't complain. (cherry picked from commit dd1e48c) Co-authored-by: Felix Fontein <[email protected]>
SUMMARY
Use
antsibull-docs lint-collection-docs --plugin-docs
to do additional documentation validation. This is important if the docs build workflow is no longer there (#6344).This also ensures that no semantic markup is used. This should be changed once the last Ansible 6.x.y release is out containing this collection; from then on we can (relatively) safely start using semantic markup without defacing the Ansible 7 (or before) documentation.
ISSUE TYPE
COMPONENT NAME
CI