Skip to content

Feature request: Project badges #5633

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
ntimo opened this issue Jan 4, 2019 · 13 comments
Open

Feature request: Project badges #5633

ntimo opened this issue Jan 4, 2019 · 13 comments
Labels
type/feature Completely new functionality. Can only be merged if feature freeze is not active. type/proposal The new feature has not been accepted yet but needs to be discussed first.

Comments

@ntimo
Copy link

ntimo commented Jan 4, 2019

Description

It would be super nice if you could add bagdes to a project like the way you can add them in Gitlab this would enable repository maintainers to clearly show the status of their pipelines or code coverage reports without having to out the into the readme.md. The badges should addable via the repo settings with a link_url and a image_url setting.

Screenshots

Example from GitLab:
gitlab-project-badges

@StevenPolley
Copy link

I haven't used gitlab but aren't these badges typically a part of the CICD system and not the version control system?

@ntimo
Copy link
Author

ntimo commented Jan 6, 2019

Kind of yes, but you can also use them to display your code coverage report from SonarQube for example :)

@techknowlogick techknowlogick added type/proposal The new feature has not been accepted yet but needs to be discussed first. type/feature Completely new functionality. Can only be merged if feature freeze is not active. labels Jan 6, 2019
@strk
Copy link
Member

strk commented Jan 19, 2022

It would be great to be able to finally STOP polluting the README.md with all the non-human-readable crap

@lunny
Copy link
Member

lunny commented Jan 20, 2022

But you can preview the README badges when you clone it locally.

@wxiaoguang
Copy link
Contributor

What about putting the badges in the repository description? Then render these images in Markdown.

@strk
Copy link
Member

strk commented Jan 20, 2022

But you can preview the README badges when you clone it locally.

Do people actually tend to open README.md files with tools capable of rendering the images in them ?
Myself I always open README files with a pager (less,more,view,...) just expecting text-only, nicely formatted to be somewhat machine-readable, but still for text-only (console?) consumption!

Badges in repository description I guess would be a possible workaround, but proper space for badges sounds even better to me, given the widespread use of badges.

@strk
Copy link
Member

strk commented Jan 24, 2022

I just experienced that the GitLab way of doing this has the limit of NOT allowing people to send pull-requests to add badges, so while I still think that it is nice to have an ad-hoc space for rendering the badges, it would be also good for the badges information to be in a file in the repository, like .badges.yml or something. That way different mirrors might eventually end up rendering the same badges too

@strk
Copy link
Member

strk commented Jan 24, 2022

Or .badges.md if people really do render the markdown-with-images locally.
Or .header.md to be rendered before README.md, to be more generic and less intrusive in the life of text-only console-based reading of README files ?

@lafriks
Copy link
Member

lafriks commented Jan 25, 2022

.yaml could be better option imho, also would be nice to allow way for badges to pass branch/tag name in image url, so that it would be possible to link to specific version/branch docs/build status etc

@belliash
Copy link

belliash commented Jun 7, 2023

Gitea gained actions (CI/CD) feature. Can this be implemented now as a part of Gitea Actions?

@lunny
Copy link
Member

lunny commented Jun 8, 2023

Gitea gained actions (CI/CD) feature. Can this be implemented now as a part of Gitea Actions?

I think they are different features.

@senare
Copy link

senare commented Sep 25, 2023

Yes, please don't bundle this with Gitea Actions !

I think use case is bigger and not all of use use Gitea Actions ...

@robe2
Copy link

robe2 commented Nov 7, 2023

But you can preview the README badges when you clone it locally.

Do people actually tend to open README.md files with tools capable of rendering the images in them ? Myself I always open README files with a pager (less,more,view,...) just expecting text-only, nicely formatted to be somewhat machine-readable, but still for text-only (console?) consumption!

I do yes. VS Code can preview markdown and see the badges. But to be honest, only reason I preview is when I edit.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type/feature Completely new functionality. Can only be merged if feature freeze is not active. type/proposal The new feature has not been accepted yet but needs to be discussed first.
Projects
None yet
Development

Successfully merging a pull request may close this issue.

10 participants