From mboxrd@z Thu Jan 1 00:00:00 1970 From: Chris Marusich Subject: Re: Doc: reference to guix-devel for submitting patches Date: Sat, 29 Apr 2017 19:48:15 -0700 Message-ID: <87inlmhaq8.fsf@gmail.com> References: <20170426180210.1efae0c4@mykolab.ch> Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:56924) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1d4euP-0008R6-Dz for guix-devel@gnu.org; Sat, 29 Apr 2017 22:48:26 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1d4euM-0001Dy-9M for guix-devel@gnu.org; Sat, 29 Apr 2017 22:48:25 -0400 Received: from mail-pg0-x232.google.com ([2607:f8b0:400e:c05::232]:35734) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1d4euM-0001Dm-38 for guix-devel@gnu.org; Sat, 29 Apr 2017 22:48:22 -0400 Received: by mail-pg0-x232.google.com with SMTP id o3so26565967pgn.2 for ; Sat, 29 Apr 2017 19:48:21 -0700 (PDT) In-Reply-To: <20170426180210.1efae0c4@mykolab.ch> (petter@mykolab.ch's message of "Wed, 26 Apr 2017 18:02:09 +0200") List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Petter Cc: guix-devel@gnu.org --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Petter writes: > Hi Guix, > > I quite recently realized I sent a couple of patches to guix-devel, where= as > they should now go to guix-patches. I use the online manual and the curre= nt > state is that there's a couple of references to guix-devel for submitting > patches. > > https://www.gnu.org/software/guix/manual/html_node/Submitting-Patches.htm= l#Submitting-Patches >>We welcome contributions in the form of patches as produced by git format= -patch >> sent to the mailing list > Where "mailing list" is mailto:guix-devel@gnu.org. This is updated in the > repository however, so I assume the online manual will reflect this short= ly. In the current master branch, this has been changed to "guix-patches". Perhaps somebody needs to update the website, too? The website is only updated periodically, so sometimes it is out of date. > > > But here, > https://www.gnu.org/software/guix/manual/html_node/Contributing.html#Cont= ributing > it says >> Please get in touch with us on guix-devel@gnu.org and #guix on the Freen= ode >> IRC network. We welcome ideas, bug reports, patches, and anything that m= ay be >> helpful to the project. > Yes, this wording is unclear. It could be interpreted as an invitation to send bug reports and patches to guix-devel@, which is not quite right. On related note, I see there is a section on submitting patches ((guix) Submitting Patches), but there is no similar, dedicated, section on submitting bugs (i.e., to bug-guix). > > And here, > https://www.gnu.org/software/guix/manual/html_node/Packaging-Guidelines.h= tml#Packaging-Guidelines > the user is referred to the Contributing node. >> Once your package builds correctly, please send us a patch (see Contribu= ting). > > I think at least one of the latter two nodes could use an update to better > inform the soon-to-be-contributor that patches should go to guix-patches.= Not > sure what the better fix is though. > > What do you think? > Seems to me like we should clarify the wording in the "Contributing" section. And maybe we should add a "Submitting Bug Reports" sub-section, similar to the "Submitting Patches" one. Do you think you could try your hand at writing this? =2D-=20 Chris --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEEy/WXVcvn5+/vGD+x3UCaFdgiRp0FAlkFUG8ACgkQ3UCaFdgi Rp3zxg/+Ms4pAyH2IohsLwkxrvSQXLbjejzjKx5rTBf2ImLhwOaEFdxJkLlOYSrw dDLUR5S8ODlWr8nTBPKg/ksaUQUZlu1hKRnW2eFxuR1ITMBHKaoUJg2FvorsLwmu Z/psmW21yLjddx+yvewDd8J5zVuTrYQtSxyqWJEjLPIirjwg/HHuhSKE1DpAzSUT Wndu8H/I6Lk4m8801wcUjpy0u3Fj2RsVw7Jc8uDQGGpaYrdne8IlahYEkzVkSd/J kjSFx807eT64XDEEw0rCgzFrlZJjSD/I0E8geCWQQrTcZ3nG+e+oEo6/b4sa8Kcu waEw0Hk4HZyy+f2BMU6LMjPDPkkapg2Obhoa9QBh1IGoKxEDjTBkUR9ITiyW1YeY 95PL0nQ6xF+TN8jpj+sVMXF8kPEUs2Tn0HqgM4Rl1REn+VREr+xR2k7UUu0mReYg 4zV4OP3lDHUspgWwXIDtQquzlzcIn7gsAsrXmkXJZkSppdGYVuqcKkZbrKc63eV3 zTZRCLDG7w7CBTBzdPMEcmvRKgDS65p+sV7GeHuCtTqYXaMc6ANgMtg8MbsqB2qY 5nfH5E2Vk2QfpQkt9iQVRnt6Ngmxe2T4V0vmWZXRH5EDK0D4oj56GJWIDETPVXSz 203r2c9aip0mhf27BEw7LuMqwcnjkzgyhKqi5GIRDhbURV619ww= =po59 -----END PGP SIGNATURE----- --=-=-=--