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 swapped docs for Rot2::rotation_to/from_y #14307

Merged
merged 1 commit into from
Jul 14, 2024

Conversation

mweatherley
Copy link
Contributor

Objective

Fixes #14301

Solution

Swap them so that they are no longer swapped.

@mweatherley mweatherley added C-Docs An addition or correction to our documentation D-Trivial Nice and easy! A great choice to get started with Bevy A-Math Fundamental domain-agnostic mathematical operations S-Needs-Review Needs reviewer attention (from anyone!) to move forward labels Jul 14, 2024
@mweatherley mweatherley added this to the 0.14.1 milestone Jul 14, 2024
@alice-i-cecile alice-i-cecile added S-Ready-For-Final-Review This PR has been approved by the community. It's ready for a maintainer to consider merging it and removed S-Needs-Review Needs reviewer attention (from anyone!) to move forward labels Jul 14, 2024
@@ -229,7 +229,7 @@ impl Dir2 {
self.rotation_from_x().inverse()
}

/// Get the rotation that rotates this direction to the Y-axis.
/// Get the rotation that rotates the Y-axis to this direction.
Copy link
Member

Choose a reason for hiding this comment

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

Question: would it be clearer and/or easier to remember if we used the term "from" in the docs?

Suggested change
/// Get the rotation that rotates the Y-axis to this direction.
/// Get the rotation that rotates to this direction from the Y-axis.

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 tried this out, but I found that it makes the wording a little weird between the to/from method docs, so I think I'm going to leave it alone for now.

@alice-i-cecile alice-i-cecile added this pull request to the merge queue Jul 14, 2024
Merged via the queue into bevyengine:main with commit e13c72d Jul 14, 2024
33 checks passed
mockersf pushed a commit that referenced this pull request Aug 2, 2024
# Objective

Fixes #14301 

## Solution

Swap them so that they are no longer swapped.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-Math Fundamental domain-agnostic mathematical operations C-Docs An addition or correction to our documentation D-Trivial Nice and easy! A great choice to get started with Bevy 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.

Wildly inconsistent documentation on Dir2 <-> Rot2 conversion methods.
3 participants