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

Fix the doc warning attribute and document remaining items for bevy_window #9933

Merged
merged 1 commit into from
Sep 27, 2023

Conversation

Kanabenki
Copy link
Contributor

Objective

Complete the documentation for bevy_window.

Solution

The warn(missing_doc) attribute was only applying to the cursor module as it was declared as an inner attribute. I switched it to an outer attribute and documented the remaining items.

@mockersf
Copy link
Member

get_display_handle and get_window_handle seems to not be needed as the field they access are public. Could you try removing them instead of documenting them?

Document the remaining items, fix the doc warning attribute and remove
some unused getters
@mockersf mockersf added C-Docs An addition or correction to our documentation A-Windowing Platform-agnostic interface layer to run your app in labels Sep 26, 2023
@@ -1,6 +1,12 @@
#![allow(clippy::type_complexity)]
#![warn(missing_docs)]
Copy link
Member

Choose a reason for hiding this comment

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

Should we just #[deny(missing_docs)] here from now on?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I kept warn since that's what seems to be intended to be put for all crates in the long run, according to #3492.

Copy link
Member

Choose a reason for hiding this comment

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

Gotcha!

@mockersf mockersf 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 Sep 27, 2023
@mockersf mockersf added this pull request to the merge queue Sep 27, 2023
Merged via the queue into bevyengine:main with commit 35d3213 Sep 27, 2023
24 checks passed
rdrpenguin04 pushed a commit to rdrpenguin04/bevy that referenced this pull request Jan 9, 2024
…window` (bevyengine#9933)

# Objective

Complete the documentation for `bevy_window`.

## Solution

The `warn(missing_doc)` attribute was only applying to the `cursor`
module as it was declared as an inner attribute. I switched it to an
outer attribute and documented the remaining items.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-Windowing Platform-agnostic interface layer to run your app in 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.

3 participants