Skip to content
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

Merged
merged 8 commits into from
Apr 16, 2023

Conversation

felixfontein
Copy link
Collaborator

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
  • Docs Pull Request
  • Test Pull Request
COMPONENT NAME

CI

@felixfontein felixfontein marked this pull request as draft April 16, 2023 12:26
@codecov
Copy link

codecov bot commented Apr 16, 2023

Codecov Report

Merging #165 (5ba19d2) into main (a7f47c0) will not change coverage.
The diff coverage is n/a.

@@           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           
Flag Coverage Δ
integration 66.86% <ø> (ø)
sanity 22.23% <ø> (ø)
units 84.54% <ø> (ø)

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.

@felixfontein felixfontein marked this pull request as ready for review April 16, 2023 16:03
@felixfontein felixfontein reopened this Apr 16, 2023
@felixfontein felixfontein merged commit dd1e48c into ansible-collections:main Apr 16, 2023
@patchback
Copy link

patchback bot commented Apr 16, 2023

Backport to stable-1: 💚 backport PR created

✅ Backport PR branch: patchback/backports/stable-1/dd1e48c388c65d40e898fb65f034d404d7d08289/pr-165

Backported as #167

🤖 @patchback
I'm built with octomachinery and
my source is open — https://github.com/sanitizers/patchback-github-app.

@felixfontein felixfontein deleted the docs branch April 16, 2023 17:01
patchback bot pushed a commit that referenced this pull request Apr 16, 2023
…#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)
felixfontein added a commit that referenced this pull request Apr 16, 2023
…#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]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant