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

[Merged by Bors] - remove a doc(hidden) on read only version of derive(WorldQuery) #6877

Closed
wants to merge 2 commits into from

Conversation

BoxyUwU
Copy link
Member

@BoxyUwU BoxyUwU commented Dec 7, 2022

having doc(hidden) on the read only version of a generated mutable world query leads to docs on the readonly item having a dead link. It also makes it annoying to have nice docs for libraries attempting to expose derived WorldQuery structs as re-exporting the read only item does not cause it to appear in docs even though it would be intended for users to know about the read only world query and use it.

@BoxyUwU BoxyUwU added the C-Docs An addition or correction to our documentation label Dec 7, 2022
@BoxyUwU BoxyUwU added the A-ECS Entities, components, systems, and events label Dec 7, 2022
@alice-i-cecile alice-i-cecile 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 Dec 7, 2022
@BoxyUwU
Copy link
Member Author

BoxyUwU commented Dec 7, 2022

also updated the doc comments on the struct since they referred to it as "internal" which would be rather confusing if intended for actual usage lol.

before this PR:
image
after this PR:
image

long term it would be nice to improve derive(WorldQuery) to let you provide your own struct instead of automatically generating stuff 👀

@mockersf
Copy link
Member

mockersf commented Dec 7, 2022

bors r+

bors bot pushed a commit that referenced this pull request Dec 7, 2022
…6877)

having `doc(hidden)` on the read only version of a generated mutable world query leads to docs on the readonly item having a dead link. It also makes it annoying to have nice docs for libraries attempting to expose derived `WorldQuery` structs as re-exporting the read only item does not cause it to appear in docs even though it would be intended for users to know about the read only world query and use it.
@bors bors bot changed the title remove a doc(hidden) on read only version of derive(WorldQuery) [Merged by Bors] - remove a doc(hidden) on read only version of derive(WorldQuery) Dec 7, 2022
@bors bors bot closed this Dec 7, 2022
@james7132 james7132 added this to the 0.10 milestone Dec 8, 2022
alradish pushed a commit to alradish/bevy that referenced this pull request Jan 22, 2023
…evyengine#6877)

having `doc(hidden)` on the read only version of a generated mutable world query leads to docs on the readonly item having a dead link. It also makes it annoying to have nice docs for libraries attempting to expose derived `WorldQuery` structs as re-exporting the read only item does not cause it to appear in docs even though it would be intended for users to know about the read only world query and use it.
ItsDoot pushed a commit to ItsDoot/bevy that referenced this pull request Feb 1, 2023
…evyengine#6877)

having `doc(hidden)` on the read only version of a generated mutable world query leads to docs on the readonly item having a dead link. It also makes it annoying to have nice docs for libraries attempting to expose derived `WorldQuery` structs as re-exporting the read only item does not cause it to appear in docs even though it would be intended for users to know about the read only world query and use it.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-ECS Entities, components, systems, and events 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