changeset 2034:709fa2841b83

doc update: add stable branch guidelines
author Tony Theodore <tonyt@logyst.com>
date Sun, 23 Oct 2011 04:15:46 +1100
parents 3123399c241c
children 0213fe9deb5c
files doc/index.html
diffstat 1 files changed, 54 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/doc/index.html	Sun Oct 23 00:31:55 2011 +1100
+++ b/doc/index.html	Sun Oct 23 04:15:46 2011 +1100
@@ -462,6 +462,14 @@
         </p>
     </dd>
 
+    <dt>Release Updates</dt>
+    <dd>
+        <p>
+        If you are experiencing problems with a release
+        (e.g. broken download links), try the 
+        <a href="#development">stable development branch.</a>
+    </dd>
+    
     <dt>Old Releases</dt>
     <dd>
         <a href="#history">History</a>
@@ -474,6 +482,45 @@
 <h2 id="development">Development Version</h2>
 
     <p>
+    For the sake of simplicity, there are two development
+    branches - "default" and "stable". Although it might
+    seem obvious, here's an overview of the types of
+    changes that go into each branch:
+    </p>
+
+    <ul class="compact-list">
+        <li>
+            Any change in the build scripts goes into "default".
+        </li>
+        <li>
+            Any package upgrade goes into "default".
+        </li>
+        <li>
+            Any documentation upgrade that refers to a feature
+            not present in stable goes into "default".
+        </li>
+        <li>
+            Anything else that doesn't effect the build goes
+            into "stable".
+        </li>
+        <li>
+            Any non-critical improvement to the main Makefile
+            goes into "stable".
+        </li>
+        <li>
+            Any improvement in the package download URLs or
+            package version recognition goes into "stable".
+        </li>
+        <li>
+            When in doubt, use "default" rather than "stable".
+        </li>
+        <li>
+            After a successful testing phase, the whole "default"
+            branch will be merged (moved) into "stable".
+        </li>
+    </ul>
+
+    <p>
     To obtain the current development version,
     install
     <a href="http://mercurial.selenic.com/">Mercurial</a>
@@ -483,6 +530,13 @@
     <pre>hg clone http://hg.savannah.nongnu.org/hgweb/mingw-cross-env</pre>
 
     <p>
+    The stable version can be obtained by:
+    </p>
+
+    <pre>hg clone -b stable \
+        http://hg.savannah.nongnu.org/hgweb/mingw-cross-env</pre>
+    
+    <p>
     To retrieve updates, run:
     </p>