Skip to content

Document composition order for Transform#23336

Merged
mockersf merged 1 commit intobevyengine:mainfrom
glocq:document-transform-composition-order
Mar 15, 2026
Merged

Document composition order for Transform#23336
mockersf merged 1 commit intobevyengine:mainfrom
glocq:document-transform-composition-order

Conversation

@glocq
Copy link
Copy Markdown
Contributor

@glocq glocq commented Mar 12, 2026

Objective

It is not obvious whether t1 * t2 means that t1 should be applied before or after t2. There may be a convention for matrix multiplication, but:

  1. Not everyone may be familiar with it
  2. It is not obvious that Transforms follow the same convention.

Solution

This specifies what the composition order is in the docs.

Testing

Nothing to test except checking that the documentation builds and displays correctly, which I did by running cargo doc and opening the result with a web browser.

@github-actions
Copy link
Copy Markdown
Contributor

Welcome, new contributor!

Please make sure you've read our contributing guide and we look forward to reviewing your pull request shortly ✨

@kfc35 kfc35 added C-Docs An addition or correction to our documentation D-Trivial Nice and easy! A great choice to get started with Bevy A-Transform Translations, rotations and scales S-Needs-Review Needs reviewer attention (from anyone!) to move forward D-Straightforward Simple bug fixes and API improvements, docs, test and examples and removed D-Trivial Nice and easy! A great choice to get started with Bevy labels Mar 12, 2026
@kfc35 kfc35 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 Mar 15, 2026
@mockersf mockersf added this pull request to the merge queue Mar 15, 2026
Merged via the queue into bevyengine:main with commit 9df74c1 Mar 15, 2026
51 checks passed
splo pushed a commit to splo/bevy that referenced this pull request Mar 31, 2026
# Objective

It is not obvious whether `t1 * t2` means that `t1` should be applied
before or after `t2`. There may be a convention for matrix
multiplication, but:
1. Not everyone may be familiar with it
2. It is not obvious that `Transform`s follow the same convention.

## Solution

This specifies what the composition order is in the docs.

## Testing

Nothing to test except checking that the documentation builds and
displays correctly, which I did by running `cargo doc` and opening the
result with a web browser.

Co-authored-by: Grégoire Locqueville <git@glocq.com>
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 D-Straightforward Simple bug fixes and API improvements, docs, test and examples 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