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

Inverse missing_docs logic #11676

Merged
merged 15 commits into from
Feb 3, 2024
Merged

Conversation

tguichaoua
Copy link
Contributor

Objective

Currently the missing_docs lint is allowed-by-default and enabled at crate level when their documentations is complete (see #3492).
This PR proposes to inverse this logic by making missing_docs warn-by-default and mark crates with imcomplete docs allowed.

Solution

Makes missing_docs warn at workspace level and allowed at crate level when the docs is imcomplete.

@Kanabenki Kanabenki added C-Docs An addition or correction to our documentation A-Build-System Related to build systems or continuous integration labels Feb 3, 2024
Copy link
Member

@alice-i-cecile alice-i-cecile left a comment

Choose a reason for hiding this comment

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

Nice! It's neat to see the value of this demonstrated by catching issues in our examples.

@matiqo15 matiqo15 added the S-Ready-For-Final-Review This PR has been approved by the community. It's ready for a maintainer to consider merging it label Feb 3, 2024
@mockersf mockersf added this pull request to the merge queue Feb 3, 2024
Merged via the queue into bevyengine:main with commit 694c06f Feb 3, 2024
26 of 27 checks passed
@tguichaoua tguichaoua deleted the inverse_missing_docs branch February 3, 2024 21:56
tjamaan pushed a commit to tjamaan/bevy that referenced this pull request Feb 6, 2024
# Objective

Currently the `missing_docs` lint is allowed-by-default and enabled at
crate level when their documentations is complete (see bevyengine#3492).
This PR proposes to inverse this logic by making `missing_docs`
warn-by-default and mark crates with imcomplete docs allowed.

## Solution

Makes `missing_docs` warn at workspace level and allowed at crate level
when the docs is imcomplete.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-Build-System Related to build systems or continuous integration C-Docs An addition or correction to our documentation S-Ready-For-Final-Review This PR has been approved by the community. It's ready for a maintainer to consider merging it
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants