Skip to content

Conversation

@stephenfin
Copy link
Contributor

@stephenfin stephenfin commented Aug 15, 2023

Feature or Bugfix

Feature

Purpose

Currently, the coverage builder lets you check for partially documented modules, but there is no mechanism to identify totally undocumented modules. Resolve this by introducing a new coverage_modules config option. This is a list of modules that should be documented somewhere within the documentation tree. Any modules that are specified in the configuration value but are not documented anywhere will result in a warning. Likewise, any modules that are not in the config option but are documented somewhere will result in a warning.

Note
I have a WIP series locally that will complete the documentation for this module and close out #1288, but I'm keeping that out of this to avoid making it any more complicated than necessary.

Detail

(none)

Relates

(none)

@stephenfin stephenfin force-pushed the coverage-all-modules branch 2 times, most recently from 573b65f to 02942b0 Compare August 15, 2023 13:30
@stephenfin stephenfin force-pushed the coverage-all-modules branch 3 times, most recently from bb5c3c3 to 334c21c Compare September 4, 2023 12:00
@stephenfin
Copy link
Contributor Author

I'll wait for the test to re-run, but it looks like the CI failures are flakes and this is otherwise passing as expected.

@AA-Turner Who's the best person other than me to review this and try get it into 7.3/8.0?

@stephenfin
Copy link
Contributor Author

fwiw, I came up with this after spotting the gap while trying to use coverage for a project I contribute to. After testing, it seemed to do what I expected and highlighted a whole load of missing documentation.

Copy link
Member

@picnixz picnixz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we need some extra tests?

@stephenfin
Copy link
Contributor Author

Do we need some extra tests?

Yes, we do. Added now

@stephenfin stephenfin force-pushed the coverage-all-modules branch 2 times, most recently from 9b75042 to 31829a9 Compare September 5, 2023 17:58
Copy link
Member

@picnixz picnixz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just so that you know, I didn't review the doc content.

@stephenfin
Copy link
Contributor Author

Just so that you know, I didn't review the doc content.

Thanks. I think I have addressed everything now?

@picnixz
Copy link
Member

picnixz commented Sep 11, 2023

I think so. At least I don't have anything more in mind, except the todo for the doc but as you mentioned, it'll be another PR

Copy link
Member

@AA-Turner AA-Turner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good, two notes

A

@stephenfin stephenfin force-pushed the coverage-all-modules branch from ca6ad22 to 34c02ff Compare October 6, 2023 13:46
@stephenfin
Copy link
Contributor Author

@AA-Turner this is done now

@stephenfin stephenfin force-pushed the coverage-all-modules branch from 34c02ff to d474029 Compare October 6, 2023 14:04
stephenfin and others added 6 commits July 4, 2024 17:47
Currently, the coverage builder lets you check for partially documented
modules, but there is no mechanism to identify totally undocumented
modules. Resolve this by introducing a new 'coverage_modules' config
option. This is a list of modules that should be documented somewhere
within the documentation tree. Any modules that are specified in the
configuration value but are not documented anywhere will result in a
warning. Likewise, any modules that are not in the config option but are
documented somewhere will result in a warning.

Signed-off-by: Stephen Finucane <[email protected]>
This prevent the table changing every time we generate the report.

Signed-off-by: Stephen Finucane <[email protected]>
We migrate the code we're measuring coverage for to a package so we can
validate the new module coverage functionality.

Signed-off-by: Stephen Finucane <[email protected]>
Signed-off-by: Stephen Finucane <[email protected]>
Co-authored-by: Adam Turner <[email protected]>
@stephenfin stephenfin force-pushed the coverage-all-modules branch from 3a799d2 to c16453e Compare July 4, 2024 16:53
@AA-Turner AA-Turner merged commit 6b37a6b into sphinx-doc:master Jul 11, 2024
@AA-Turner
Copy link
Member

Thanks!

A

@stephenfin stephenfin deleted the coverage-all-modules branch July 11, 2024 17:45
@AA-Turner AA-Turner added this to the 7.4.0 milestone Jul 13, 2024
@github-actions github-actions bot locked as resolved and limited conversation to collaborators Aug 13, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants