As any active software developer, I tend to have a lot of projects laying about. With the advent of Github all of these projects now live in the public eye.
For me, as the author, it isn't dificult to keep track of which project is in which state of production. For the casual visitor of my project pages this is a different matter.
To help passers-by to identify how solid a certain project is at-a-glance, I felt it would be prudent to offer them a "Badge". Some uniform way of knowing what to expect of the code in the repository without even having to look at it.
Before a visitor can be alerted of which stage of production a project is in, these stages need to be defined. After some general research on what are the most common terms used elsewhere I came up with the following list:
- C
- R
- E
- D
- .
- !
- ?
This project is in its
- Concept
- Research
- Experiment
- Development
- Production Ready
- ! Deprecated
- ? Unknown
stage.
It would be nice to be able to display these stages in an uniform manner across projects. Preferably in a way that mirrors the look and feel of other badge providers.
This can quite easily be achieved using the excellent service provided by Shields.io:
- no image required
One-liners for badges in markdown files are less readable and less maintainable, so use the following instead.
The link for all badges is the same, pointing to this page.
<img alt="Project stage: Concept" src="https://img.shields.io/badge/Project%20Stage-Concept-red.svg" />
[![Project stage: Concept][project-stage-badge: Concept]][project-stage-page]
[project-stage-badge: Concept]: https://img.shields.io/badge/Project%20Stage-Concept-red.svg
[project-stage-page]: https://blog.pother.ca/project-stages/
<img alt="Project stage: Research" src="https://img.shields.io/badge/Project%20Stage-Research-orange.svg" />
[![Project stage: Research][project-stage-badge: Research]][project-stage-page]
[project-stage-badge: Research]: https://img.shields.io/badge/Project%20Stage-Research-orange.svg
[project-stage-page]: https://blog.pother.ca/project-stages/
<img alt="Project stage: Experimental" src="https://img.shields.io/badge/Project%20Stage-Experimental-yellow.svg" />
[![Project stage: Experimental][project-stage-badge: Experimental]][project-stage-page]
[project-stage-badge: Experimental]: https://img.shields.io/badge/Project%20Stage-Experimental-yellow.svg
[project-stage-page]: https://blog.pother.ca/project-stages/
<img alt="Project stage: Development" src="https://img.shields.io/badge/Project%20Stage-Development-yellowgreen.svg" />
[![Project stage: Development][project-stage-badge: Development]][project-stage-page]
[project-stage-badge: Development]: https://img.shields.io/badge/Project%20Stage-Development-yellowgreen.svg
[project-stage-page]: https://blog.pother.ca/project-stages/
<img alt="Project stage: Production Ready" src="https://img.shields.io/badge/Project%20Stage-Production%20Ready-brightgreen.svg" />
[![Project stage: Production Ready][project-stage-badge: Production Ready]][project-stage-page]
[project-stage-badge: Production Ready]: https://img.shields.io/badge/Project%20Stage-Production%20Ready-brightgreen.svg
[project-stage-page]: https://blog.pother.ca/project-stages/
<img alt="Project stage: DEPRECATED" src="https://img.shields.io/badge/Project%20Stage-%20!%20DEPRECATED%20%20%20!-ff0000.svg" />
[![Project stage: DEPRECATED][project-stage-badge: DEPRECATED]][project-stage-page]
[project-stage-badge: DEPRECATED]: https://img.shields.io/badge/Project%20Stage-%20!%20DEPRECATED%20%20%20!-ff0000.svg
[project-stage-page]: https://blog.pother.ca/project-stages/
Any questions or feedback can be Tweeted to @potherca
The source of this page is available on GitHub under a Creative Commons Attribution-ShareAlike 4.0 International License — Created by Potherca