summary refs log tree commit diff
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2016-07-28 15:24:37 +0200
committerLudovic Courtès <ludo@gnu.org>2016-07-28 15:24:37 +0200
commit189b1543cbc2db50e6dd309e84bce4eb503f0493 (patch)
tree5a52ae74e4def54170720ac6c22e7dbc7343246f
parent6547708f718316dac79de845aabb7220122385a7 (diff)
downloadguix-189b1543cbc2db50e6dd309e84bce4eb503f0493.tar.gz
doc: Mention separate branch for packages with many dependents.
Suggested by ng0 <ng0@we.make.ritual.n0.is>.

* doc/contributing.texi (Submitting Patches): Add note on packages with
more than 100 dependents.
-rw-r--r--doc/contributing.texi7
1 files changed, 7 insertions, 0 deletions
diff --git a/doc/contributing.texi b/doc/contributing.texi
index c0755bb895..6496e10a14 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -300,6 +300,13 @@ For important changes, check that dependent package (if applicable) are
 not affected by the change; @code{guix refresh --list-dependent
 @var{package}} will help you do that (@pxref{Invoking guix refresh}).
 
+Packages with roughly 100 dependents or more usually have to be
+committed to a separate branch.  That branch can then be built
+separately by our build farm, and later 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.
+
 @item
 @cindex determinism, of build processes
 @cindex reproducible builds, checking