Currently, our icon documentation is located within the Octicons library, which can be overlooked when browsing through our guidelines. This pull request aims to centralize all of our documentation by moving the icon page to our guidelines and improving it.
Our ultimate goal is to centralize all of our documentation for easier access. However, I have intentionally left the Octicons design guidelines in place for now, as I believe it is still the best place for information on creating new icons. I have added a section called Creating New Icons
to direct users to this information.
In the past year, we have received numerous questions about using Octicons as selectable icons for users. To address this, I have added a section called System vs User-Selectable
to compile past discussions on this topic.
I've also simplified our icon pairing section as those guidelines were very inconsistent and confusing.
The do and don't section are also now improved.
The Special
section also adds more strict documentation on using special icons.
Preview: https://primer-a9164a06d1-26441320.drafts.github.io/components/icon