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

Added Documentation to all_tuples_with_size #14832

Merged

Conversation

bushrat011899
Copy link
Contributor

Objective

Solution

  • Added documentation to all_tuples_with_size based on existing all_tuples documentation.
  • Updated all_tuples documentation to match formatting of and link back to all_tuples_with_size

Testing

  • Doctests ran locally.

Notes

Formatting changes I have proposed make the documentation a little cleaner in my opinion, but I am open to reverting them and amending all_tuples_with_size to match if there are any reasonable objections.

Also updated the existing documentation of `all_tuples` to reference `all_tuples_with_size`, and pretty its formatting. Examples for `all_tuples_with_size` match `all_tuples` to highlight how the two helper macros compliment each other.
@bushrat011899 bushrat011899 added C-Docs An addition or correction to our documentation A-Utils Utility functions and types D-Straightforward Simple bug fixes and API improvements, docs, test and examples D-Domain-Agnostic Can be tackled by anyone with generic programming or Rust skills D-Macros Code that generates Rust code labels Aug 20, 2024
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.

What else do you intend to do in this PR before taking it out of draft?

@alice-i-cecile alice-i-cecile added the S-Waiting-on-Author The author needs to make changes or address concerns before this can be merged label Aug 20, 2024
@bushrat011899
Copy link
Contributor Author

What else do you intend to do in this PR before taking it out of draft?

Just want to make sure CI fully passed first (which it hasn't quite yet!). Just thought I'd put this up in draft in the meantime so it could be looked through while we wait.

Also updated the existing documentation of `all_tuples` to reference `all_tuples_with_size`, and pretty its formatting. Examples for `all_tuples_with_size` match `all_tuples` to highlight how the two helper macros compliment each other.
@bushrat011899 bushrat011899 marked this pull request as ready for review August 20, 2024 02:05
@bushrat011899 bushrat011899 removed the S-Waiting-on-Author The author needs to make changes or address concerns before this can be merged label Aug 20, 2024
@TrialDragon TrialDragon added the S-Needs-Review Needs reviewer attention (from anyone!) to move forward label Aug 20, 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 Aug 20, 2024
@alice-i-cecile alice-i-cecile added this pull request to the merge queue Aug 20, 2024
Merged via the queue into bevyengine:main with commit f59a6a9 Aug 20, 2024
28 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-Utils Utility functions and types C-Docs An addition or correction to our documentation D-Domain-Agnostic Can be tackled by anyone with generic programming or Rust skills D-Macros Code that generates Rust code 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.

Document all_tuples_with_size, and its difference to all_tuples
4 participants