Document how to reference a label in GitHub-flavored Markdown #18537

Activity

1. TonyGravagno

   added

   contentThis issue or pull request belongs to the Docs Content teamThis issue or pull request belongs to the Docs Content team

   on Jun 10, 2022
2. welcome commented on Jun 10, 2022

   

   welcomebot

   on Jun 10, 2022

   More actions

   Thanks for opening this issue. A GitHub docs team member should be by to give feedback soon. In the meantime, please check out the contributing guidelines.

   👍React with 👍1Reacted by Mochamad Iqbal Dwi Cahyo
3. github-actions

   added

   triageDo not begin working on this issue until triaged by the teamDo not begin working on this issue until triaged by the team

   on Jun 10, 2022
4. PythonCoderAS commented on Jun 11, 2022

   

   PythonCoderAS

   on Jun 11, 2022

   Contributor

   More actions

   I don't think this is allowed because shields.io is a third-party service.
5. TonyGravagno commented on Jun 12, 2022

   

   TonyGravagno

   on Jun 12, 2022

   Last edited by TonyGravagno

   Author

   More actions

   I don't think this is allowed because shields.io is a third-party service.

   Thanks for the challenge...

   • There's no reason not to reference another site. Other sites are mentioned in these docs for similar purposes.
   • In particular, shields.io site is not competitive with Github or Microsoft.
   • There is no endorsement or implication of affiliation with a reference to that site.
   • That site is non-commercial, publicly supported, and entirely based on the badges/shields FOSS hosted here at Github.
   • It's not a volatile link. There are 5.7 million instances in Github public repo code where shields.io is already used for dynamic and static badges. The suggestion here is simply to document the established standard for what people already do, and change it later in the almost certain never to happen scenario where the site changes.
   • Microsoft could choose to fork and implement the shields project, and suggest to all that they can get shields from there. A decision had been made not to do that. Given that decision it seems reasonable to support documenting how to use the feature at it exists.
   • This doc page documents how to add a dynamic badge for workflow, using data from this site as the source. Because this site doesn't document how to use other dynamic data that is readily available, people in the FOSS community filled the gap. That saved Github/Microsoft some effort and should be rewarded with a reciprocal gesture of recognition. Let's document how to get the data from github.com directly, if it's possible, or, let's document where we know people can use this existing functionality. It's just data.

   Ref functionality supported by the Github API, implemented in the badge/shields project FOSS (source for shields.io).

   See also the badges/shields PR for this.

   Ping @pfaion @calebcartwright
6. PythonCoderAS commented on Jun 12, 2022

   

   PythonCoderAS

   on Jun 12, 2022

   Contributor

   More actions

   @TonyGravagno let me be clear, the issue is describing it enough that it seems to be official. I was thinking something that would be acceptable could be a sentence that just reads "Third-party services like shields.io allow dynamically creating images of repository labels."
7. TonyGravagno commented on Jun 12, 2022

   

   TonyGravagno

   on Jun 12, 2022

   Author

   More actions

   I agree that would be ideal and I will ensure it's presented like this if the enhancement is approved. Thanks.
8. janiceilene commented on Jun 15, 2022

   

   janiceilene

   on Jun 15, 2022

   Contributor

   More actions

   👋 Thanks so much for opening an issue and clearly explaining your reasoning @TonyGravagno! Since this isn't a GitHub feature and is a totally optional thing that users can choose to add if they're interested, we're not going to add it to the docs 💛

   Thank you for your interest and passion in improving the GitHub docs! ✨
9. janiceilene

   closed this as completedon Jun 15, 2022
10. styfle commented on Jun 17, 2022

    

    styfle

    on Jun 17, 2022

    More actions

    It seems like GitHub must have a native way to do this because I'm seeing it in this PR: nodejs/node#43310

    

    I'm not seeing this feature documented however so perhaps its beta? 🤔
11. PythonCoderAS commented on Jun 17, 2022

    

    PythonCoderAS

    on Jun 17, 2022

    Contributor

    More actions

    It seems like GitHub must have a native way to do this because I'm seeing it in this PR: nodejs/node#43310

    

    I'm not seeing this feature documented however so perhaps its beta? 🤔

    Oh it's simple, just put in a normal link to the label. For example:

    https://github.com/github/docs/labels/content

    -> content This issue or pull request belongs to the Docs Content team

    👍React with 👍11Reacted by Steven, Patrick Faion, Mochamad Iqbal Dwi Cahyo, Victor Lin, Dustin Engstrom, Miguel Ambrona, Philip Taron, Martin Price, Georgios Adzhygai, Angel Tepavicharov and 1 more

    🎉React with 🎉3Reacted by Patrick Faion, Angel Tepavicharov and xamidi

    ❤️React with ❤️8Reacted by Patrick Faion, Mochamad Iqbal Dwi Cahyo, Ricardo G. Sousa, Miguel Ambrona, Angel Tepavicharov, xamidi, Dvd-Znf and Angela Tran
12. styfle commented on Jun 17, 2022

    

    styfle

    on Jun 17, 2022

    More actions

    Cool! I don't see that documented though.

    Perhaps it should be added to Autolinked References and URLs

    👍React with 👍2Reacted by Patrick Faion and PythonCoderAS
13. PythonCoderAS commented on Jun 17, 2022

    

    PythonCoderAS

    on Jun 17, 2022

    Contributor

    More actions

    Maybe open a different issue for that?
14. Sakhilemasina commented on Jun 17, 2022

    

    Sakhilemasina

    on Jun 17, 2022 via email

    More actions

    is my job application to glassdoor successful?

    …

    On Fri, 10 Jun 2022, 20:52 Tony Gravagno, ***@***.***> wrote: Code of Conduct - I have read and agree to the GitHub Docs project's Code of Conduct <https://github.com/github/docs/blob/main/CODE_OF_CONDUCT.md> What article on docs.github.com is affected? https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax What part(s) of the article would you like to see updated? #referencing-issues-and-pull-requests <https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#referencing-issues-and-pull-requests> I propose adding a new section here, "Referencing Labels". This feature is not directly supported by Github, but it is possible in a standard manner with a feature provided by shields.io. For example: [image: label: github/docs/labels/content] <https://camo.githubusercontent.com/88ffd2affeb1676fb3f37ddf2e141ad01eaa1cb31f16ab7acf168fcb6c10f642/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6162656c732f6769746875622f646f63732f636f6e74656e74> is created with image link:  Documentation: https://shields.io/category/issue-tracking - See and click topic 'GitHub labels'. Because this is dynamically generated, the color of the image is always accurate at the time of rendering/viewing, not just at the time of text entry. The alt text covers for missing images or communications issues. As this is a useful and requested <isaacs/github#305> feature, I think it would be helpful to add the suggestion to the doc, even if the feature is not built-in to Github itself. If the shields.io service goes away, Github will have much greater issues than this one feature, and the doc can be modified as required. TY Additional information On approval, I'll submit a PR for the new content. Someone may suggest adding notes about shields for milestones and other features supported by shields.io. I suggest we process this one request first and consider other such requests on their own merits. — Reply to this email directly, view it on GitHub <#18537>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AV73JDUVKJGMCHRJUZYWLR3VOOFH3ANCNFSM5YOROTBA> . You are receiving this because you are subscribed to this thread.Message ID: ***@***.***>

    👎React with 👎7Reacted by PythonCoderAS, Steven, Patrick Faion, Ian Wahbe, Alan Orth, Michael Chirico and Izaakwltn
15. styfle commented on Jun 18, 2022

    

    styfle

    on Jun 18, 2022

    More actions

    I created #18704
16. xamidi commented on Feb 8, 2025

    

    xamidi

    on Feb 8, 2025

    Last edited by xamidi

    More actions

    Oh it's simple, just put in a normal link to the label. For example:

    content This issue or pull request belongs to the Docs Content team

    -> content This issue or pull request belongs to the Docs Content team

    That's really cool!

    I'd like to mention that in case someone wishes to show labels outside of the repo that defines them, and (like me) dislikes that https://img.shields.io/ distorts color and shape of labels, it still can be done.

    For example, https://img.shields.io/github/labels/xamidi/pmGenerator/challenge is
    ,
    but (as in xamidi/pmGenerator#2) it should be
    .

    I simply uploaded and linked an SVG

    <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="63" height="20" role="img" aria-label="challenge">
      <title>challenge</title>
      <g>
        <rect width="63" height="20" fill="#ffcb00" rx="10"/>
      </g>
      <g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110">
        <text x="315" y="140" transform="scale(.1)" fill="#333" textLength="530">challenge</text>
      </g>
    </svg>
    

    to and from this comment.

    I took color and dimensions from img.shields.io's code (where color distortion is only due to some linearGradient overlay).

    👍React with 👍1Reacted by Tony Gravagno