summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDylan Baker <dylan@pnwbakers.com>2019-10-24 13:21:45 -0700
committerDylan Baker <dylan@pnwbakers.com>2019-10-25 15:46:19 -0700
commitca0c1e69cab67276b2f701f7c3ea43658a52fd83 (patch)
tree934587a276e7f0efa38b02261c89018813cf8ae5 /docs
parent8a4541aae22e0cdeb063e3fc25c84775d84f4077 (diff)
docs: update releasing process to use new scripts and gitlab
There were several out of date entries in this document, update them to current practices. Reviewed-by: Juan A. Suarez <jasuarez@igalia.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/releasing.html49
1 files changed, 12 insertions, 37 deletions
diff --git a/docs/releasing.html b/docs/releasing.html
index d2dc72ff7a4..7c4e213fb92 100644
--- a/docs/releasing.html
+++ b/docs/releasing.html
@@ -26,8 +26,7 @@
<li><a href="#prerelease">Pre-release announcement</a>
<li><a href="#release">Making a new release</a>
<li><a href="#announce">Announce the release</a>
-<li><a href="#website">Update the mesa3d.org website</a>
-<li><a href="#bugzilla">Update Bugzilla</a>
+<li><a href="#gitlab">Update Gitlab Issues</a>
</ul>
@@ -517,35 +516,21 @@ So we do a quick 'touch test'
unset VK_ICD_FILENAMES
</pre>
-<h3>Update version in file VERSION</h3>
-
-<p>
-Increment the version contained in the file VERSION at Mesa's top-level, then
-commit this change.
-</p>
-
<h3>Create release notes for the new release</h3>
<p>
-Create a new file docs/relnotes/X.Y.Z.html, (follow the style of the previous
-release notes). Note that the sha256sums section of the release notes should
-be empty (TBD) at this point.
-</p>
+The release notes are completely generated by the
+<pre>bin/gen_release_notes.py</pre> script. Simply run this script before
+bumping the version
-<p>
-Two scripts are available to help generate portions of the release notes:
+The only thing left to do is add the sha256 sums.
</p>
-<pre>
- ./bin/bugzilla_mesa.sh
- ./bin/shortlog_mesa.sh
-</pre>
+<h3>Update version in file VERSION</h3>
<p>
-The first script identifies commits that reference bugzilla bugs and obtains
-the descriptions of those bugs from bugzilla. The second script generates a
-log of all commits. In both cases, HTML-formatted lists are printed to stdout
-to be included in the release notes.
+Increment the version contained in the file VERSION at Mesa's top-level, then
+commit this change.
</p>
<p>
@@ -591,11 +576,9 @@ Something like the following steps will do the trick:
git cherry-pick -x X.Y
</pre>
-<p>
-Also, edit docs/relnotes.html to add a link to the new release notes,
-edit docs/index.html to add a news entry and a note in case of the
-last release in a series, and remove the version from
-docs/release-calendar.html. Then commit and push:
+<p>Then run the <pre>./bin/post_verison.py X.Y.Z</pre>, where X.Y.Z is the
+version you just made. This will updated docs/relnotes.html and
+docs/index.html. Remove docs/release-calendar.html. Then commit and push:
</p>
<pre>
@@ -616,15 +599,7 @@ series, if that is the case.
</p>
-<h2 id="website">Update the mesa3d.org website</h2>
-
-<p>
-As the hosting was moved to freedesktop, git hooks are deployed to update the
-website. Manually check that it is updated 5-10 minutes after the final <code>git push</code>
-</p>
-
-
-<h2 id="bugzilla">Update Bugzilla</h2>
+<h2 id="gitlab">Update gitlab issues</h2>
<p>
Parse through the bugreports as listed in the docs/relnotes/X.Y.Z.html