Rename EndOfLifeTor to ReleaseSeriesLifecycle; expand it.

Closes ticket 30917.
This commit is contained in:
Nick Mathewson 2020-02-14 08:47:17 -05:00
parent a6509cb867
commit 455ea05bdf

View File

@ -1,10 +1,11 @@
End of Life on an old release series End of Life on an old release series
------------------------------------ ------------------------------------
Here are the steps that the maintainer should take when an old Tor release Here are the steps that the maintainer should take when an old Tor release
series reaches End of Life. Note that they are _only_ for entire series that series reaches End of Life. Note that they are _only_ for entire series that
have reached their planned EOL: they do not apply to security-related has reached its planned EOL: they do not apply to security-related
deprecations of individual versions. deprecations of individual versions.
### 0. Preliminaries ### 0. Preliminaries
@ -24,6 +25,7 @@ deprecations of individual versions.
- tor's Travis CI cron jobs - tor's Travis CI cron jobs
- chutney's Travis CI tests (#) - chutney's Travis CI tests (#)
- stem's Travis CI tests (#) - stem's Travis CI tests (#)
- tor's scripts/git/* scripts
2. Close the milestone in Trac. To do this, go to Trac, log in, 2. Close the milestone in Trac. To do this, go to Trac, log in,
select "Admin" near the top of the screen, then select "Milestones" from select "Admin" near the top of the screen, then select "Milestones" from
@ -48,3 +50,49 @@ deprecations of individual versions.
number from their approved versions list. number from their approved versions list.
7. Update the CoreTorReleases wiki page. 7. Update the CoreTorReleases wiki page.
8. Update the git/hooks
9. Finally, make sure this document is up to date with our latest
process.
10. Open a ticket (if there is not one already) for authorities to
start rejecting relays that are running that release series.
This ticket should be targeted for at least a month or two
after the series is officially EOL, unless there is an important
reason to un-list relays early.
11. Open a ticket (if appropriate) for updates to the set of
required and recommended subprotocol versions.
Starting a new release series.
------------------------------
(Ideally, do this immediately after a release.)
1. Start a new maint-x.y.z branch based on master, and a new
release-x.y.z branch based on master. They should have the same
starting point.
Push both of these branches to the master git repository.
2. In master, change the version to "0.x.y.0-alpha-dev". Run the
update_versions.py script, and commit this version bump.
3. Tag the version bump with "tor-0.x.y.0-alpha-dev". Push the tag
and master.
4. Open tickets for connecting the new branches to various other
places, including:
- Jenkins CI
- travis cronjobs
- chutney travis configuration
- Tor's scripts/git scripts.
5. Remove "check-best-practices" from the check-local Makefile
target in maint-x.y.z branch only. Merge to release-0.xy.z but do
not forward-port to master.
6. Finally, make sure this document is up to date with our latest
process.