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.
This commit is contained in:
Ludovic Courtès 2016-07-28 15:24:37 +02:00
parent 6547708f71
commit 189b1543cb
No known key found for this signature in database
GPG key ID: 090B11993D9AEBB5

View file

@ -300,6 +300,13 @@ For important changes, check that dependent package (if applicable) are
not affected by the change; @code{guix refresh --list-dependent not affected by the change; @code{guix refresh --list-dependent
@var{package}} will help you do that (@pxref{Invoking guix refresh}). @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 @item
@cindex determinism, of build processes @cindex determinism, of build processes
@cindex reproducible builds, checking @cindex reproducible builds, checking