document brand icons for verified actions in the marketplace

[jsoref]

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?

https://docs.github.com/en/actions/creating-actions/publishing-actions-in-github-marketplace
https://docs.github.com/en/actions/creating-actions/metadata-syntax-for-github-actions#branding

What part(s) of the article would you like to see updated?

Add text that talks about the icon that can be shown when one verifies an action (or something).

My assumption is that the right place for the documentation would be https://docs.github.com/en/actions/creating-actions/publishing-actions-in-github-marketplace, although it'd be nice if https://docs.github.com/en/actions/creating-actions/metadata-syntax-for-github-actions#branding said "If you verify your action you can use a fancier brand icon instead, see publishing actions in github marketplace for details." or something like that.

Additional information

https://docs.github.com/en/actions/creating-actions/publishing-actions-in-github-marketplace#about-badges-in-github-marketplace has pictures that show icons that are obviously not listed in https://docs.github.com/en/actions/creating-actions/metadata-syntax-for-github-actions#branding but there's nothing that explains how this works.

[nguyenalex836]

@jsoref Thanks for opening an issue! I'll get this triaged for review ✨

[felicitymay]

Thanks for raising this interesting question. My assumption is that when an organization publishes an action, it automatically inherits the profile image for that organization (for example, Snyk and Atlassian), but that you can override this default by defining branding.

You can see that the https://github.com/marketplace/actions/snyk-node action, created by someone outside the Snyk organization uses the Feather alert-circle icon and that this is defined in the branding metadata for the action: https://github.com/awshole/snyk-node/blob/13b3b80f6e799f615fb8275464e69f04a7fa7057/action.yml#L4-L5.

In contrast, branding is undefined by this action released by the Snyk organization, see https://github.com/snyk/release-notes-preview/blob/master/action.yaml.

Before we add anything about this to the documentation, I'd like to get this confirmed by a subject matter expert.

[github-actions]

Thanks for opening an issue! We've triaged this issue for technical review by a subject matter expert 👀