Skip to content

Fill gaps in image encoding documentation, fix how python documents union variants#4988

Merged
Wumpf merged 12 commits intomainfrom
andreas/image-encoding-documentation
Feb 1, 2024
Merged

Fill gaps in image encoding documentation, fix how python documents union variants#4988
Wumpf merged 12 commits intomainfrom
andreas/image-encoding-documentation

Conversation

@Wumpf
Copy link
Copy Markdown
Member

@Wumpf Wumpf commented Jan 31, 2024

What

Turned out union documentation didn't look great so I improved this a bit
image

Checklist

  • I have read and agree to Contributor Guide and the Code of Conduct
  • I've included a screenshot or gif (if applicable)
  • I have tested the web demo (if applicable):
  • The PR title and labels are set such as to maximize their usefulness for the next release's CHANGELOG

@Wumpf Wumpf added 📖 documentation Improvements or additions to documentation include in changelog labels Jan 31, 2024
@emilk emilk self-requested a review February 1, 2024 17:29
Copy link
Copy Markdown
Member

@emilk emilk left a comment

Choose a reason for hiding this comment

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

Nice!

Comment on lines +40 to +44
* "Radians":
3D rotation angle in radians. Only one of `degrees` or `radians` should be set.

* "Degrees":
3D rotation angle in degrees. Only one of `degrees` or `radians` should be set.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Did you check how this looks in the generated python docs?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Yep, that's the reason I leave so much space because otherwise it doesn't look great. This is what it looks like with the changes from this PR:

image

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

hmm actually could still be better. the "only one of should be set" is a bit confusing ion this case, but then I also find the entire pattern a bit confusing 🤷

@Wumpf Wumpf merged commit a287d9c into main Feb 1, 2024
@Wumpf Wumpf deleted the andreas/image-encoding-documentation branch February 1, 2024 19:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

📖 documentation Improvements or additions to documentation include in changelog

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Missing documentation for ImageEncoded and NV12 support

2 participants