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

docs - sphinx - fail on warnings #949

Merged
merged 4 commits into from
Feb 23, 2023

Conversation

briantist
Copy link
Contributor

Resolves #946

The docs build tests don't fail on warnings, and it means we can miss some pretty egregious stuff.

This PR will attempt to fail on warnings, and then fix any outstanding warnings we have so that we're in a good state to catch these things on future PRs.

@briantist briantist added documentation documentation updates and/or requests for expanded documentation CI/CD related to CI/CD (not necessarily tests) labels Feb 19, 2023
@briantist briantist added this to the 1.1.0 milestone Feb 19, 2023
@briantist briantist self-assigned this Feb 19, 2023
@codecov
Copy link

codecov bot commented Feb 19, 2023

Codecov Report

Merging #949 (6d9d999) into develop (d7e9557) will decrease coverage by 0.32%.
The diff coverage is n/a.

@@             Coverage Diff             @@
##           develop     #949      +/-   ##
===========================================
- Coverage    81.64%   81.33%   -0.32%     
===========================================
  Files           65       65              
  Lines         3002     2968      -34     
===========================================
- Hits          2451     2414      -37     
- Misses         551      554       +3     
Impacted Files Coverage Δ
hvac/api/auth_methods/cert.py 91.04% <ø> (ø)
hvac/api/auth_methods/mfa.py 91.17% <0.00%> (-8.83%) ⬇️
hvac/v1/__init__.py 85.61% <0.00%> (-1.65%) ⬇️
hvac/api/vault_api_category.py 94.44% <0.00%> (-0.68%) ⬇️
hvac/adapters.py 86.45% <0.00%> (-0.28%) ⬇️
hvac/utils.py 77.06% <0.00%> (-0.21%) ⬇️
hvac/api/secrets_engines/identity.py 93.98% <0.00%> (-0.03%) ⬇️
hvac/api/secrets_engines/kv.py 100.00% <0.00%> (ø)

@briantist briantist marked this pull request as ready for review February 19, 2023 17:31
@briantist briantist requested a review from a team as a code owner February 19, 2023 17:31
@briantist briantist merged commit d25a320 into hvac:develop Feb 23, 2023
@briantist briantist deleted the docs/fail-on-warnings branch February 23, 2023 04:11
@briantist
Copy link
Contributor Author

@dhuckins thanks for reviewing this!

briantist added a commit that referenced this pull request Mar 6, 2023
* docs - sphinx - fail on warnings

* fix invalid line in cert documentation

* fix markdown files

* pin docutils to fix issue with sphinx
briantist added a commit to briantist/hvac that referenced this pull request May 10, 2023
* docs - sphinx - fail on warnings

* fix invalid line in cert documentation

* fix markdown files

* pin docutils to fix issue with sphinx
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
CI/CD related to CI/CD (not necessarily tests) documentation documentation updates and/or requests for expanded documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Documentation tests should fail on sphinx warnings
2 participants