A standard to easily communicate to humans and machines the development/support and usability status of software repositories/projects.
Python CSS HTML JavaScript Ruby
Permalink
Failed to load latest commit information.
badges
gh_pages
parsers
.gitignore
CHANGELOG.md
CONTRIBUTORS.md
LICENSE.txt
README.md
fabfile.py

README.md

repostatus.org

Project Status: Active – The project has reached a stable, usable state and is being actively developed.

A standard to easily communicate to humans and machines the development/support and usability status of software repositories/projects.

For the majority of documentation and human-readable text, see http://www.repostatus.org/ or the gh-pages branch from which it is built.

Please feel free to leave comments as Issues, or open pull requests.

Contributing

For changes to the site, text, or anything other than the badges themselves (and their descriptions and sample markup), simply cut a pull request against the master branch. The content that appears on the website (in the gh-pages branch) comes from gh_pages/ in master. Note that some of it (described below) is generated programmatically.

The badges (SVG), their descriptions and their sample markup are generated by a Fabfile. If you're looking to add a new badge or make changes to an existing one, simply update the badge_info dictionary at the top of fabfile.py and then run fab make_badges (requires Python and some packages; see the comment at the top of the file for requirements). This will regenerate all badges, metadata and samples into badges/latest. You can then cut a pull request for this; a version number will be assigned at merge time. Please remember to also update gh_pages/index.md for any badge changes.

Release Process

  1. Get everything included in the release merged into master.
  2. Assign a version number. In general, patch versions should only be assigned for releases that fix trivial (i.e. spelling) issues or touch things other than the badges and JSON (i.e. the markup samples). Minor versions should be assigned to changes that correct grammatical or spelling errors, or graphical elements. Major versions must be assigned to any changes that add or remove badges, or alter the meaning of existing badges.
  3. Re-run fab make_badges and ensure there are no new changes.
  4. Run fab version_badges:x.y.z (where x.y.z is the version number).
  5. Add a CHANGELOG.md entry.
  6. Run fab badges2pages to copy the badges under gh-pages/
  7. Run fab publish to push changes to the gh-pages branch.
  8. Review the diff of gh-pages against origin.
  9. Assuing all is well, push gh-pages to origin. The changes are now live.
  10. Tag master with the version number (use GitHub Releases)