From mboxrd@z Thu Jan 1 00:00:00 1970 From: swedebugia Subject: Re: Contributing to the manual Date: Sat, 10 Nov 2018 08:18:26 +0100 Message-ID: References: <99ce18fddfb263735384f2798c6b1fe8@riseup.net> 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]:56797) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gLNXg-00081V-SI for guix-devel@gnu.org; Sat, 10 Nov 2018 02:18:53 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gLNXb-0000S0-6D for guix-devel@gnu.org; Sat, 10 Nov 2018 02:18:52 -0500 Received: from mx1.riseup.net ([198.252.153.129]:50517) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gLNXZ-000071-Aa for guix-devel@gnu.org; Sat, 10 Nov 2018 02:18:46 -0500 In-Reply-To: Content-Language: en-US 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: quiliro@fsfla.org, guix-devel@gnu.org Hi On 2018-11-10 05:14, Quiliro Ordonez wrote: snip > Thank you very much for your instructions G=C3=A1bor. > > I understand that I must do git checkout and modify the file > guix/doc/guix.texi and no other texi file. Then I must git commit and > then git push. git push won't work if you are not a committer see below how to use format-patch instead > But I do not feel so sure about making the changes that I > propose or about a the best tools to do it quickly. To be clear: I am > not so confident about acceptability of my changes and about the time I > must use. > > If someone would comment on my proposals I would feel more confident > about making a commit myself. And if someone would tell me what tools t= o > use and refer to methods for editing files the quickest way, I would > feel better about not using so much of my time. I know this hand-holdin= g > is a lot of work. But it would be just this time. > > Of course that I could make the changes and those might not be > incorporated on the master. So there is no risk with my commit. Of > course that I could take 40 hours to make the changes. I don't understand what part of this process would take 40 hours. Lets start with a few edits and go from there. See below > I ask for help in > order for me to gain confidence that my work will be of use and that I > am not taking a year to move a centimeter. Does that make sense? Yes, that makes sense. Thanks for taking your time with this. I found a couple of the same omissions but by far this is the most=20 thorough once-over anyone has subjected the manual to to my knowledge. :) Unfortunately I do not understand some of your notes so I cannot make=20 them on your behalf. If you don't feel confident making the changes, how about we do like this= : You download guix.texi here:=20 http://git.savannah.gnu.org/cgit/guix.git/plain/doc/guix.texi Make a few related changes (typos e.g.) Email me or guix-devel the file describing your edits. - alternatively you could install git and do git --depth=3D1 https://git.savannah.gnu.org/git/guix.git make a few related changes to doc/guix.texi git commit (explain what you did, preferably following how other doc:=20 commits look in guix, see=20 http://git.savannah.gnu.org/cgit/guix.git/log/doc/guix.texi?qt=3Dgrep&q=3D= doc%3A=20 or read the contributing section in the manual) git format-patch HEAD~1 (will export the last commit as a patch) email the resulting patch-file to this thread or preferably to=20 guix-patches@gnu.org -- alternatively you could install a git gui and do it all from there. e.g.=20 gitg https://wiki.gnome.org/Apps/Gitg --=20 Cheers Swedebugia