03/05: doc: Discourage software bundling.

[Ludovic Courtès]

civodul pushed a commit to branch master
in repository guix.

commit d222522edf70cdac6cee7b4ab8fa1bfbf0a7ba9c
Author: Ludovic Courtès <address@hidden>
Date:   Thu Jul 28 15:41:00 2016 +0200

    doc: Discourage software bundling.
    
    Fixes <http://bugs.gnu.org/24008>.
    Suggested by ng0 <address@hidden>.
    
    * doc/contributing.texi (Submitting Patches): Add item about bundling.
---
 doc/contributing.texi |   14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/doc/contributing.texi b/doc/contributing.texi
index a3684a5..18d891d 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -289,6 +289,20 @@ Make sure the package builds on your platform, using 
@code{guix build
 @var{package}}.
 
 @item
address@hidden bundling
+Make sure the package does not use bundled copies of software already
+available as separate packages.
+
+Sometimes, packages include copies of the source code of their
+dependencies as a convenience for users.  However, as a distribution, we
+want to make sure that such packages end up using the copy we already
+have in the distribution, if there is one.  This improves resource usage
+(the dependency is built and stored only once), and allows the
+distribution to make transverse changes such as applying security
+updates for a given software package in a single place and have them
+affect the whole system---something that bundled copies prevent.
+
address@hidden
 Take a look at the profile reported by @command{guix size}
 (@pxref{Invoking guix size}).  This will allow you to notice references
 to other packages unwillingly retained.  It may also help determine