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

Improve color notation in the docs #3165

Merged
merged 1 commit into from
Oct 11, 2024

Conversation

damusss
Copy link
Contributor

@damusss damusss commented Oct 10, 2024

Notation about color values in the docs was messy and scattered. Since pygame.typing.ColorLike exists, the docs should point to it to be elegant. (Note: even if 2.5.2 is not out yet, clicking on the data tag will still bring a user to a list of allowed values).

color.rst was not changed as it dives deeper on the allowed values, nor gfxdraw.rst since 1) it's not supposed to be used, 2) not all color values are actually supported, but we shouldn't worry about fixing any of this since it's not supposed to be used.

I also modified referring to RGB when it should have actually said Color (pygame.Color) or color (pygame.typing.ColorLike).

@damusss damusss added the docs label Oct 10, 2024
@damusss damusss requested a review from a team as a code owner October 10, 2024 17:26
Copy link
Contributor

@bilhox bilhox left a comment

Choose a reason for hiding this comment

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

LGTM !

Copy link
Member

@ankith26 ankith26 left a comment

Choose a reason for hiding this comment

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

LGTM, thanks 🎉

@bilhox bilhox merged commit 1b05ef7 into pygame-community:main Oct 11, 2024
28 checks passed
@ankith26 ankith26 added this to the 2.5.2 milestone Oct 11, 2024
@damusss damusss deleted the use-ColorLike-docs branch October 17, 2024 17:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants