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

Add docs to bevy_sprite a little #10947

Merged
merged 5 commits into from
Dec 14, 2023
Merged

Conversation

akimakinai
Copy link
Contributor

Objective

  • bevy_sprite crate is missing docs for important types. Sprite being undocumented was especially confusing for me even though it is one of the first types I need to learn.

Solution

  • Improves the situation a little by adding some documentations.
    I'm unsure about my understanding of functionality and writing. I'm happy to be pointed out any mistakes.

@nicopap nicopap added C-Docs An addition or correction to our documentation A-Rendering Drawing game state to the screen labels Dec 12, 2023
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.

Great progress, some suggestions :)

akimakinai and others added 2 commits December 13, 2023 22:40
Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
@akimakinai
Copy link
Contributor Author

Thanks, applied suggestions.

Copy link
Contributor

@Nilirad Nilirad left a comment

Choose a reason for hiding this comment

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

It just needs a some changes to improve correctness and consistency. For the rest it is OK.

crates/bevy_sprite/src/bundle.rs Outdated Show resolved Hide resolved
crates/bevy_sprite/src/bundle.rs Outdated Show resolved Hide resolved
crates/bevy_sprite/src/bundle.rs Outdated Show resolved Hide resolved
crates/bevy_sprite/src/bundle.rs Outdated Show resolved Hide resolved
crates/bevy_sprite/src/collide_aabb.rs Outdated Show resolved Hide resolved
#[derive(Default)]
pub struct SpritePlugin;

pub const SPRITE_SHADER_HANDLE: Handle<Shader> = Handle::weak_from_u128(2763343953151597127);

/// Set system for the systems relating to sprite rendering.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
/// Set system for the systems relating to sprite rendering.
/// System labels for sprite rendering.

The wording is a little weird and "set system" is not a common form.

Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
/// Set system for the systems relating to sprite rendering.
/// System set for sprite rendering.

Alternative version.

crates/bevy_sprite/src/sprite.rs Outdated Show resolved Hide resolved
crates/bevy_sprite/src/lib.rs Outdated Show resolved Hide resolved
crates/bevy_sprite/src/texture_atlas.rs Outdated Show resolved Hide resolved
Co-authored-by: Federico Rinaldi <gisquerin@gmail.com>
@hymm hymm 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 14, 2023
@alice-i-cecile alice-i-cecile added this pull request to the merge queue Dec 14, 2023
Merged via the queue into bevyengine:main with commit 83fbf48 Dec 14, 2023
23 checks passed
@akimakinai akimakinai deleted the sprite_doc branch December 15, 2023 19:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-Rendering Drawing game state to the screen 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