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] - Adding transform example links to documentation #5997

Closed
wants to merge 9 commits into from

Conversation

bwhitt7
Copy link
Contributor

@bwhitt7 bwhitt7 commented Sep 16, 2022

Objective

Working on issue #1934 , with linking examples to the documentation. PR for transform examples.

Solution

Added to the documentation in bevy_transform transform.rs and global_transform.rs utilizing links from examples.

[X] 3d_rotations.rs linked to rotate in Transform
[X] global_vs_local_translation.rs linked to top of Transform and GlobalTransform documentation
[X] scale.rs linked to scale Struct in Transform
[X] transform.rs linked to top of Transform documentation
[X] translation.rs linked to from_translation in Transform

@alice-i-cecile
Copy link
Member

You can also see in the CI that it's complaining about lack of formatting :) https:/bevyengine/bevy/actions/runs/3070501643/jobs/4960290437

That's an easy fix; just follow the directions there.

@alice-i-cecile alice-i-cecile added C-Docs An addition or correction to our documentation A-Transform Translations, rotations and scales labels Sep 16, 2022
@alice-i-cecile
Copy link
Member

Can you mention that this is for the Transform examples in your PR title? They get turned into commit names so it's useful to see what exactly was done at a glance.

@bwhitt7 bwhitt7 changed the title Adding example links to documentation Adding transform example links to documentation Sep 16, 2022
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.

Got there :D I'm happy with this now; I think that this will help improve discoverability nicely.

@alice-i-cecile
Copy link
Member

@bwhitt7 you can press "Resolve conversation" on the comments you've addressed. It's very useful for reviewers so they can have a better idea of the current state of the PR.

@bwhitt7
Copy link
Contributor Author

bwhitt7 commented Sep 17, 2022

@alice-i-cecile gotcha! thank you for your help

Copy link
Contributor

@djeedai djeedai left a comment

Choose a reason for hiding this comment

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

Looks mostly good, thanks for helping the documentation effort!

@@ -26,14 +26,22 @@ use std::ops::Mul;
/// This system runs in stage [`CoreStage::PostUpdate`](crate::CoreStage::PostUpdate). If you
/// update the [`Transform`] of an entity in this stage or after, you will notice a 1 frame lag
/// before the [`GlobalTransform`] is updated.
///
/// Examples: [`transform`](https:/bevyengine/bevy/blob/latest/examples/transforms/transform.rs), [`global_vs_local_translation.rs`](https:/bevyengine/bevy/blob/latest/examples/transforms/global_vs_local_translation.rs)
Copy link
Contributor

Choose a reason for hiding this comment

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

We should settle on either including or excluding the .rs extension, but avoid mixing styles.

crates/bevy_transform/src/components/transform.rs Outdated Show resolved Hide resolved
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.

Good job. I suggested to list the example links into a dedicated “Examples” section. Vertical space is not an issue for those items. The only exception was for the fields, where it's nice to have visually compact info. I also paraphrased there to make it a little nicer to read.

I also converted link style to reference, for readability. Finally I removed the .rs extension in the link text.

crates/bevy_transform/src/components/global_transform.rs Outdated Show resolved Hide resolved
crates/bevy_transform/src/components/transform.rs Outdated Show resolved Hide resolved
crates/bevy_transform/src/components/transform.rs Outdated Show resolved Hide resolved
crates/bevy_transform/src/components/transform.rs Outdated Show resolved Hide resolved
crates/bevy_transform/src/components/transform.rs Outdated Show resolved Hide resolved
crates/bevy_transform/src/components/transform.rs Outdated Show resolved Hide resolved
@bwhitt7
Copy link
Contributor Author

bwhitt7 commented Sep 18, 2022

@Nilirad thank you for your suggestions, i think these are really nice changes. i've never used github much before, so I'm unsure where to go from here. would i commit your suggestions?

@alice-i-cecile
Copy link
Member

You can go the Files Changed tab, add the suggestions to a batch and then commit the suggestions :)

@Nilirad
Copy link
Contributor

Nilirad commented Sep 19, 2022

Co-authored-by: Federico Rinaldi <[email protected]>
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.

I checked the output. Looks OK overall.

@Nilirad Nilirad 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 20, 2022
@alice-i-cecile
Copy link
Member

Congrats on your first merged PR :)

bors r+

bors bot pushed a commit that referenced this pull request Sep 20, 2022
# Objective

Working on issue #1934 , with linking examples to the documentation. PR for transform examples.

## Solution

Added to the documentation in bevy_transform transform.rs and global_transform.rs utilizing links from examples.

[X] 3d_rotations.rs linked to rotate in Transform
[X] global_vs_local_translation.rs linked to top of Transform and GlobalTransform documentation
[X] scale.rs linked to scale Struct in Transform
[X] transform.rs linked to top of Transform documentation
[X] translation.rs linked to from_translation in Transform

Co-authored-by: bwhitt7 <[email protected]>
@bors bors bot changed the title Adding transform example links to documentation [Merged by Bors] - Adding transform example links to documentation Sep 20, 2022
@bors bors bot closed this Sep 20, 2022
james7132 pushed a commit to james7132/bevy that referenced this pull request Oct 19, 2022
# Objective

Working on issue bevyengine#1934 , with linking examples to the documentation. PR for transform examples.

## Solution

Added to the documentation in bevy_transform transform.rs and global_transform.rs utilizing links from examples.

[X] 3d_rotations.rs linked to rotate in Transform
[X] global_vs_local_translation.rs linked to top of Transform and GlobalTransform documentation
[X] scale.rs linked to scale Struct in Transform
[X] transform.rs linked to top of Transform documentation
[X] translation.rs linked to from_translation in Transform

Co-authored-by: bwhitt7 <[email protected]>
james7132 pushed a commit to james7132/bevy that referenced this pull request Oct 28, 2022
# Objective

Working on issue bevyengine#1934 , with linking examples to the documentation. PR for transform examples.

## Solution

Added to the documentation in bevy_transform transform.rs and global_transform.rs utilizing links from examples.

[X] 3d_rotations.rs linked to rotate in Transform
[X] global_vs_local_translation.rs linked to top of Transform and GlobalTransform documentation
[X] scale.rs linked to scale Struct in Transform
[X] transform.rs linked to top of Transform documentation
[X] translation.rs linked to from_translation in Transform

Co-authored-by: bwhitt7 <[email protected]>
ItsDoot pushed a commit to ItsDoot/bevy that referenced this pull request Feb 1, 2023
# Objective

Working on issue bevyengine#1934 , with linking examples to the documentation. PR for transform examples.

## Solution

Added to the documentation in bevy_transform transform.rs and global_transform.rs utilizing links from examples.

[X] 3d_rotations.rs linked to rotate in Transform
[X] global_vs_local_translation.rs linked to top of Transform and GlobalTransform documentation
[X] scale.rs linked to scale Struct in Transform
[X] transform.rs linked to top of Transform documentation
[X] translation.rs linked to from_translation in Transform

Co-authored-by: bwhitt7 <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-Transform Translations, rotations and scales 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.

4 participants