From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mailman by lists.gnu.org with archive (Exim 4.43) id 1I4xuQ-0001LH-9F for mharc-grub-devel@gnu.org; Sun, 01 Jul 2007 07:48:06 -0400 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1I4xuP-0001L2-6n for grub-devel@gnu.org; Sun, 01 Jul 2007 07:48:05 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1I4xuM-0001Ko-Qg for grub-devel@gnu.org; Sun, 01 Jul 2007 07:48:03 -0400 Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1I4xuM-0001Kl-LO for grub-devel@gnu.org; Sun, 01 Jul 2007 07:48:02 -0400 Received: from smtp-vbr14.xs4all.nl ([194.109.24.34]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1I4xuM-00086Y-3W for grub-devel@gnu.org; Sun, 01 Jul 2007 07:48:02 -0400 Received: from localhost.localdomain (249-174.surfsnel.dsl.internl.net [145.99.174.249]) by smtp-vbr14.xs4all.nl (8.13.8/8.13.8) with ESMTP id l61BlsDF097581 for ; Sun, 1 Jul 2007 13:47:55 +0200 (CEST) (envelope-from mgerards@xs4all.nl) From: Marco Gerards To: The development of GRUB 2 References: <511f47f50706260921o7c2b99c8nd277ce492da6c984@mail.gmail.com> <87bqf2sk76.fsf@xs4all.nl> Mail-Copies-To: mgerards@xs4all.nl Date: Sun, 01 Jul 2007 13:48:33 +0200 In-Reply-To: (Khaled Hosny's message of "Wed, 27 Jun 2007 16:17:43 +0300") Message-ID: <87sl88jqem.fsf@xs4all.nl> User-Agent: Gnus/5.110006 (No Gnus v0.6) Emacs/21.4 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Virus-Scanned: by XS4ALL Virus Scanner X-detected-kernel: FreeBSD 4.6-4.9 Subject: Re: GRUB 2 documentation X-BeenThere: grub-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: The development of GRUB 2 List-Id: The development of GRUB 2 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 01 Jul 2007 11:48:05 -0000 "Khaled Hosny" writes: >> > I see this bug >> > http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=333516 about >> > documentation , what is the status of that, we are waiting for grub 2 >> > to hit stable before the documentation is written or what? >> >> Well, you can't write 100% accurate documentation now, but GRUB 2 will >> never be finished (as in: software is never finished), so you do not >> have to wait. Better start now and improve as we go along. >> >> Did you read the texinfo documentation from GRUB Legacy? This is the >> quality I am hoping for. So not a manpage, but good documentation >> that explains all features, etc. >> >> Really, documentation is as important as the code itself. I would >> become really happy if you would be willing to work on this. You >> don't need many technical skills and there are enough people around >> who are willing to help you, when questions arise. >> >> Do you want to work on this? It is a big job, but you can learn a lot >> from this. > > I'd like to work on this, any idea where to begin? should I start with > grub legacy documentation and update/remove/add information to match > that of grub2 or should I start from scratch? You would have to start from scratch. GRUB 2 is a rewrite and unrelated to GRUB Legacy. Only the style of the documentation should be matched, nothing else. so the verbosity and quality. -- Marco