<pre style='margin:0'>
Lawrence Velázquez (larryv) pushed a commit to branch master
in repository macports-base.
</pre>
<p><a href="https://github.com/macports/macports-base/commit/861babb418d3d9d747e98eb7feaad5ea64061013">https://github.com/macports/macports-base/commit/861babb418d3d9d747e98eb7feaad5ea64061013</a></p>
<pre style="white-space: pre; background: #F8F8F8"><span style='display:block; white-space:pre;color:#808000;'>commit 861babb418d3d9d747e98eb7feaad5ea64061013
</span>Author: Lawrence Velázquez <larryv@macports.org>
AuthorDate: Thu Nov 17 20:55:45 2016 -0500
<span style='display:block; white-space:pre;color:#404040;'> ReleaseProcess: Switch to Markdown ATX headers
</span><span style='display:block; white-space:pre;color:#404040;'>
</span><span style='display:block; white-space:pre;color:#404040;'> http://brettterpstra.com/2015/08/24/write-better-markdown/#atx-headers
</span>---
portmgr/ReleaseProcess.md | 24 ++++++++++++------------
1 file changed, 12 insertions(+), 12 deletions(-)
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/portmgr/ReleaseProcess.md b/portmgr/ReleaseProcess.md
</span><span style='display:block; white-space:pre;color:#808080;'>index 5b03747..3e43d4c 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/portmgr/ReleaseProcess.md
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/portmgr/ReleaseProcess.md
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,9 +1,9 @@
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-= MacPorts Release Process =
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+# MacPorts Release Process #
</span>
This file documents the evolving MacPorts release process.
<span style='display:block; white-space:pre;background:#ffe0e0;'>-== Goals of a Release ==
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+## Goals of a Release ##
</span>
There are several goals in the release process:
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -15,7 +15,7 @@ There are several goals in the release process:
</span> * Ensure that the user base and public is notified of the release.
<span style='display:block; white-space:pre;background:#ffe0e0;'>-== Steps to a Release ==
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+## Steps to a Release ##
</span>
The following steps to a release are documented in more detail below:
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -28,7 +28,7 @@ The following steps to a release are documented in more detail below:
</span> * Notify public of the release.
<span style='display:block; white-space:pre;background:#ffe0e0;'>-=== Create a Release Branch ===
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+### Create a Release Branch ###
</span>
For each major release (i.e. 1.9.x, 2.0.x, etc.) an appropriate branch is
created with a consistent name. To do this, two things are required:
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -53,7 +53,7 @@ its version information to indicate it's moved past the release version by
</span> setting the patch-level version to 99, e.g. 2.0.99 in config/macports_version.
<span style='display:block; white-space:pre;background:#ffe0e0;'>-=== Prepare the code for Release ===
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+### Prepare the code for Release ###
</span>
In preparation for a release, several things should be completed within the
code:
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -79,7 +79,7 @@ code:
</span> should be merged back into master as well.
<span style='display:block; white-space:pre;background:#ffe0e0;'>-=== Tag the Release ===
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+### Tag the Release ###
</span>
Once the release is ready, it must be tagged so that the release components
may be fetched in the future, to ensure replicability. Generally, a release
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -112,7 +112,7 @@ a set of ports intended to work with that release.
</span> git push origin v2.0.0-archive
<span style='display:block; white-space:pre;background:#ffe0e0;'>-=== Create & Post Release Tarballs ===
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+### Create & Post Release Tarballs ###
</span>
The release tarballs are .tar.bz2 and .tar.gz archives of the base repository.
They are named with the following naming convention:
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -137,7 +137,7 @@ https://distfiles.macports.org/MacPorts/ directory. At present, this must be
</span> done with the help of the infrastructure team.
<span style='display:block; white-space:pre;background:#ffe0e0;'>-=== Create Release Packages and Disk Image(s) ===
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+### Create Release Packages and Disk Image(s) ###
</span>
The dmg is a Mac OS X disk image that contains a standalone installer,
configured in the usual way, named in a consistent fashion and incorporating
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -212,14 +212,14 @@ and that the pkg contained therein properly starts up Installer.app when it's
</span> double-clicked.
<span style='display:block; white-space:pre;background:#ffe0e0;'>-== Create Release on GitHub ==
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+## Create Release on GitHub ##
</span>
All of our distfiles should also be available as downloads from a new GitHub
release. Create a new release matching the previously created tag on GitHub
and attach all tarballs and installers to it.
<span style='display:block; white-space:pre;background:#ffe0e0;'>-=== Make the Release Available through Self-Update ===
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+### Make the Release Available through Self-Update ###
</span>
In order to make the release version available through selfupdate, the
config/RELEASE_URL file in the base repository needs to be updated with the
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -228,7 +228,7 @@ the code available via rsync. See jobs/mprsyncup in the macports-infra
</span> repository.
<span style='display:block; white-space:pre;background:#ffe0e0;'>-=== Notify the Public of the Release ===
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+### Notify the Public of the Release ###
</span>
Once the release has been posted, notification of the release should be
sent/posted to the following places:
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -255,7 +255,7 @@ External websites:
</span> * (Where else?)
<span style='display:block; white-space:pre;background:#ffe0e0;'>-=== Use of new features in Portfiles ===
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+### Use of new features in Portfiles ###
</span>
Using new features introduced by a release should be delayed for 14 days until
being deployed in the ports tree. This should allow users to upgrade their
</pre><pre style='margin:0'>
</pre>