|
109 | 109 | <head>Building a TEI Release</head> |
110 | 110 | <p>This document aims to provide a set of detailed instructions enabling a "release |
111 | 111 | technician" (the Council member tasked with implementing a new release of the TEI) to |
112 | | - prepare for and manage the release process. It assumes that the new packages will be taken |
113 | | - from one of the Jenkins servers rather than being built locally by the release technician. |
| 112 | + prepare for and manage the release process. The release process normally involves more than one release technician. In the event that there is more than one release technician, the release technicians should coordinate and divide the various steps in the release process amongst themselves. The release process detailed below assumes that the new packages will be taken |
| 113 | + from one of the Jenkins servers rather than being built locally by the release technician(s). |
114 | 114 | This is easier and more reliable, because we ensure that the Jenkins servers are regularly |
115 | 115 | updated and are correctly configured to build the TEI products.</p> |
116 | 116 |
|
|
265 | 265 | At least one week before releasing, we enter a review period, during which the only |
266 | 266 | changes made to the code to be released should be to fix errors, rather than to add new |
267 | 267 | features. Release branches for the TEI and Stylesheets repos will be created by the |
268 | | - release technician, to which ONLY release-blocking bug fixes and corrections to |
269 | | - typographical errors will be pushed. The release technician should announce a temporary |
| 268 | + release technician(s), to which ONLY release-blocking bug fixes and corrections to |
| 269 | + typographical errors will be pushed. The release technician(s) should announce a temporary |
270 | 270 | hold on pushes to the dev branches on the Council list, then create the branches and |
271 | 271 | push it to GitHub using the following commands, once in the TEI repo and once in the |
272 | 272 | Stylesheets repo: <lb/><code>git checkout dev</code> (make sure you start from the dev |
273 | 273 | branch) or if you have the dev branch checked out, <code>git status</code> in order to |
274 | 274 | make sure that you have the current version and no uncommitted changes. <lb/><code>git |
275 | 275 | checkout -b release-X.X.X</code> |
276 | 276 | <lb/><code>git push -u origin release-X.X.X</code></item> |
277 | | - <item>Immediately after the release branches have been pushed, the release technician |
| 277 | + <item>Immediately after the release branches have been pushed, the release technician(s) |
278 | 278 | should inform the <ref target="mailto:tei-council@lists.tei-c.org">Council list</ref> |
279 | 279 | and ask the maintainers of the TEI Jenkins systems to add a build of the release branch |
280 | 280 | so that commits pushed there are properly tested, and advise them of the release |
|
0 commit comments