guix-commits
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

01/01: doc: Add recommendations for good origin URLs.


From: Pierre Neidhardt
Subject: 01/01: doc: Add recommendations for good origin URLs.
Date: Wed, 10 Oct 2018 12:07:33 -0400 (EDT)

ambrevar pushed a commit to branch master
in repository guix.

commit 4feb589bf48cbbd2d524002456fa822acf856bc3
Author: Pierre Neidhardt <address@hidden>
Date:   Wed Oct 10 18:06:08 2018 +0200

    doc: Add recommendations for good origin URLs.
    
    * doc/contributing.texi (Submitting Patches): URL recommendations.
---
 doc/contributing.texi | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/contributing.texi b/doc/contributing.texi
index 68d8e7e..91a87ef 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -468,6 +468,14 @@ Please follow our code formatting rules, possibly running 
the
 @command{etc/indent-code.el} script to do that automatically for you
 (@pxref{Formatting Code}).
 
address@hidden
+When possible, use mirrors in the source URL (@pxref{Invoking guix download}).
+Use reliable URLs, not generated ones.  For instance, GitHub archives are not
+necessarily identical from one generation to the next, so in this case it's
+often better to clone the repository.  Don't use the @command{name} field in
+the URL: it is not very useful and if the name changes, the URL will probably
+be wrong.
+
 @end enumerate
 
 When posting a patch to the mailing list, use @samp{[PATCH] @dots{}} as



reply via email to

[Prev in Thread] Current Thread [Next in Thread]