Re: GRUB 2 documentation

[Marco Gerards <mgerards@xs4all.nl>]

"Khaled Hosny" <khaledhosny@eglug.org> 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