AccessKit / AccessKit/accesskit
Document `Role::ColorWell`
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 1.5k
- Forks
- 114
- Avg merge
- 8h 25m
- Merged PRs (30d)
- 28
Description
Role::ColorWell is copied verbatim from chromium's API.
As far as I can tell, it refers to a button that opens a color picker when clicked; it refers specifically to the button, and not the color-picking widget associated to the button.
https://developer.apple.com/design/human-interface-guidelines/color-wells
I don't know how well-known the concept is; it's described in the Apple AppKit documentation and a few other frameworks, but it seems niche overall. Googling "color well" gives unhelpful results.
It's probably worth spending a few lines explaining the concept, maybe with a link to the Apple doc.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Search the repository for Role::ColorWell, then read the Apple Human Interface Guidelines color-wells documentation linked in the issue. Update the relevant documentation to explain that a color well is the button that opens a color picker, distinguish it from the picker itself, and include the Apple link.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 72/100