Skip to content

UI node bundle comment fix#9404

Merged
alice-i-cecile merged 5 commits intobevyengine:mainfrom
ickshonpe:ui-node-bundle-comment-correction
Aug 28, 2023
Merged

UI node bundle comment fix#9404
alice-i-cecile merged 5 commits intobevyengine:mainfrom
ickshonpe:ui-node-bundle-comment-correction

Conversation

@ickshonpe
Copy link
Copy Markdown
Contributor

@ickshonpe ickshonpe commented Aug 10, 2023

Objective

Doc comment for the global_transform field in NodeBundle says:

/// This field is automatically managed by the UI layout system.

The GlobalTransform component is the thing being managed, not the global_transform field, and the TransformPropagate systems do the managing, not the UI layout system.

@ickshonpe ickshonpe changed the title UI node bundle comment correction UI node bundle comment fix Aug 10, 2023
@nicopap nicopap added C-Docs An addition or correction to our documentation A-UI Graphical user interfaces, styles, layouts, and widgets labels Aug 10, 2023
Copy link
Copy Markdown
Contributor

@rparrett rparrett left a comment

Choose a reason for hiding this comment

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

Checked the rendered docs. Looks good / makes sense to me.

While reviewing I noticed that the docs for the transform fields for these various bundles all make references to NodeBundle.

@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 Aug 10, 2023
Copy link
Copy Markdown
Contributor

@Weibye Weibye left a comment

Choose a reason for hiding this comment

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

I agree this is more correct 👍

@ickshonpe
Copy link
Copy Markdown
Contributor Author

Checked the rendered docs. Looks good / makes sense to me.

While reviewing I noticed that the docs for the transform fields for these various bundles all make references to NodeBundle.

Oh yep I see, better fix that too.

@ickshonpe
Copy link
Copy Markdown
Contributor Author

ickshonpe commented Aug 11, 2023

/// To alter the position of the `NodeBundle`, use the properties of the [`Style`] component.

Changed this line for the Transform comments so it uses the name of the specific bundle.
For GlobalTransform I deleted it, as it seems odd there when GlobalTransform isn't used for mutations.

…form` field doc comment.

Deleted the same line for `GlobalTransform` as it doesn't really make sense there.
///
/// This field is automatically managed by the UI layout system.
/// This component is automatically managed by the UI layout system.
/// To alter the position of the `NodeBundle`, use the properties of the [`Style`] component.
Copy link
Copy Markdown
Contributor

@rparrett rparrett Aug 11, 2023

Choose a reason for hiding this comment

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

There's also a copy of this "NodeBundle" comment here, associated with the node field, with the same copy/paste mistake.

Seems safe to get rid of this one too to me. Not every bundle has it. But maybe it was intended that it say "to alter the size"?

@alice-i-cecile alice-i-cecile added this pull request to the merge queue Aug 14, 2023
@github-merge-queue github-merge-queue bot removed this pull request from the merge queue due to failed status checks Aug 14, 2023
@alice-i-cecile alice-i-cecile added this pull request to the merge queue Aug 14, 2023
@github-merge-queue github-merge-queue bot removed this pull request from the merge queue due to failed status checks Aug 14, 2023
@alice-i-cecile
Copy link
Copy Markdown
Member

@ickshonpe once merge conflicts are cleaned up, I'll merge this.

@alice-i-cecile alice-i-cecile added this pull request to the merge queue Aug 28, 2023
Merged via the queue into bevyengine:main with commit 05b7f60 Aug 28, 2023
rdrpenguin04 pushed a commit to rdrpenguin04/bevy that referenced this pull request Jan 9, 2024
# Objective

Doc comment for the `global_transform` field in `NodeBundle` says:

```
/// This field is automatically managed by the UI layout system.
```

The `GlobalTransform` component is the thing being managed, not the
`global_transform` field, and the `TransformPropagate` systems do the
managing, not the UI layout system.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-UI Graphical user interfaces, styles, layouts, and widgets 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.

8 participants