From mboxrd@z Thu Jan 1 00:00:00 1970 From: =?UTF-8?Q?Luis_Felipe_L=C3=B3pez_Acevedo?= Subject: Re: Merging =?UTF-8?Q?=E2=80=98HACKING=E2=80=99=20in=20the=20manu?= =?UTF-8?Q?al=3F?= Date: Sun, 31 May 2015 19:38:02 -0500 Message-ID: <7eb17310dde212e7cbc911e38178e9db@openmailbox.org> References: <87k2w1tq0y.fsf@163.com> <87h9r438er.fsf@earlgrey.lan> <87egm8h8w7.fsf@gnu.org> <87egm83019.fsf@earlgrey.lan> <87zj4ve6nm.fsf@gnu.org> <878ucf2ma7.fsf@earlgrey.lan> <87oal5dcmq.fsf@gnu.org> <87y4k921s2.fsf@openmailbox.org> <87a8wnayml.fsf@gnu.org> <878uc6p3wu.fsf@openmailbox.org> <87k2vo4kqm.fsf_-_@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:44260) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YzDk4-0005Ys-4o for guix-devel@gnu.org; Sun, 31 May 2015 20:38:13 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YzDk0-0001Du-Vh for guix-devel@gnu.org; Sun, 31 May 2015 20:38:12 -0400 In-Reply-To: <87k2vo4kqm.fsf_-_@gnu.org> 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-bounces+gcggd-guix-devel=m.gmane.org@gnu.org To: ludo@gnu.org Cc: guix , Feng Shu On 2015-05-31 14:20, ludo@gnu.org wrote: > Mathieu Lirzin skribis: >=20 >> When reacting, I didn't realize that most of your statement is=20 >> actually >> documented in the recent "Running Guix Before It Is Installed" node in >> doc/guix.texi. >>=20 >> Nevertheless, I find it not really relevant to give hacking=20 >> information >> in chapter 'Installation'. >=20 > Agreed but... >=20 >> The attached patch tries to give a better consistency in the location >> of these useful informations. >=20 > ... c71979f just did the opposite move, so no. :-) >=20 >> Even if I find this patch appropriate ;-), my personnal preference=20 >> would >> be to delete HACKING, and move all its informations in the chapter >> 'Contributing' of the Holy Bible (with appropriate refinement of >> course!) and refer to it in README. Opinions about this? >=20 > Yeah, probably. I=E2=80=99m not completely sure about moving things li= ke patch > submission and coding style in there; on one hand, it=E2=80=99s not som= ething > one would expect in a =E2=80=9Cuser manual=E2=80=9D, but on the other h= and, it=E2=80=99s nice=20 > to > have everything consistently maintained in one place. >=20 > Another option would be to have a second .texi document for these=20 > things > (like Findutils, which has a =E2=80=98findutils-maint=E2=80=99 document= .) >=20 > What do people think? I like GNUnet's use of "handbooks" to separate information. They have=20 Installation Handbook, User Handbook, and Developer Handbook. I think=20 something similar could work well for Guix. --=20 Luis Felipe L=C3=B3pez Acevedo