Release Engineering strives to use consistent tools and style conventions across all projects. To that end, the Release Engineering Project Standard (or REPS) was created.
This repo contains both the REPS definition, as well as a tool that can be used to bootstrap new projects that conform to this definition.
The standards themselves are defined in the STANDARD.md file at the root of the repo.
Bootstrapping new Projects#
The repo also provides a bootstrapping tool called
recommended way to run it is with pipx:
$ pipx run reps-new
Updating the Standards#
These project standards are a living document, and it’s encouraged that new tools, workflows and modifications be added as our best practices evolve.
If you would like to adjust a standard, the recommended process is to:
Create an issue describing the change you’d like to make, share it with the team and get general consensus that it is worth making.
If necessary, release a new version of
If necessary, update existing projects so they conform to the new standard. In general, we should strive to keep all projects synced with the latest standards, but this is not always possible in a timely manner due to conflicting priortities. So discretion can be used around the timeline for updating existing projects.