Description
Code of Conduct
- I have read and agree to the GitHub Docs project's Code of Conduct
What article on docs.github.com is affected?
Metadata syntax for GitHub Actions
What part(s) of the article would you like to see updated?
The documentation clearly conveys that branding.icon should be a Feather icon, and explicitly lists all 257 icons that may be used, helpfully linking to the Feather icons website. Considering the number of options available, it is easy to overlook the fact that the latest version of Feather icons, v4.28.0, offers an additional 29 icons that are not listed in the GitHub Docs. Particularly since the Feather icons website has a search box and displays the icons themselves, it is easy to make the mistake of selecting one of those 29 unsupported icons if you get unlucky. This raises the question of which version of Feather icons is in use, which has no answer. There is no point in the version history of Feather icons that corresponds to the exact list of icons in use, and it's not clear to me why those specific icons were removed beyond the fact that some of them are for specific software products. In light of this, it would be helpful to mention explicitly the 29 unsupported icons or at least the fact that only the listed icons are supported. (Or better yet, to support all 286 icons, and list them all along with the version of Feather icons in use.)
Additional information
This pull request lists the corresponding changes I think should eventually be made to the schema of GitHub Actions once the missing non-brand icons are supported.