doc: Clarify when branches are "frozen".
authorMarius Bakke <mbakke@fastmail.com>
Sat, 26 May 2018 13:39:13 +0000 (15:39 +0200)
committerMarius Bakke <mbakke@fastmail.com>
Sat, 16 Jun 2018 19:35:24 +0000 (21:35 +0200)
* doc/contributing.texi (Submitting Patches): Provide a link to Hydra.  Add
section about freezing branches.

doc/contributing.texi
doc/guix.texi

index 205c972..ca44b3b 100644 (file)
@@ -407,12 +407,19 @@ changes).  This branch is intended to be merged in @code{master} every
 2.5 months or so.
 @end table
 
-All these branches are tracked by our build farm
-and merged into @code{master} once
+All these branches are @uref{https://hydra.gnu.org/project/gnu,
+tracked by our build farm} and merged into @code{master} once
 everything has been successfully built.  This allows us to fix issues
 before they hit users, and to reduce the window during which pre-built
 binaries are not available.
 
+Generally, branches other than @code{master} are considered
+@emph{frozen} if there has been a recent evaluation, or there is a
+corresponding @code{-next} branch.  Please ask on the mailing list or
+IRC if unsure where to place a patch.
+@c TODO: It would be good with badges on the website that tracks these
+@c branches.  Or maybe even a status page.
+
 @item
 @cindex determinism, of build processes
 @cindex reproducible builds, checking
index a90af34..1ecb110 100644 (file)
@@ -37,7 +37,7 @@ Copyright @copyright{} 2017 Carlo Zancanaro@*
 Copyright @copyright{} 2017 Thomas Danckaert@*
 Copyright @copyright{} 2017 humanitiesNerd@*
 Copyright @copyright{} 2017 Christopher Allan Webber@*
-Copyright @copyright{} 2017 Marius Bakke@*
+Copyright @copyright{} 2017, 2018 Marius Bakke@*
 Copyright @copyright{} 2017 Hartmut Goebel@*
 Copyright @copyright{} 2017 Maxim Cournoyer@*
 Copyright @copyright{} 2017, 2018 Tobias Geerinckx-Rice@*