Re: grub.info

[address@hidden]

2009/12/31 Bruce O. Benson <address@hidden>:
>
> 2009/12/31 Vladimir 'φ-coder/phcoder' Serbinenko <address@hidden>
>>
>> Bruce O. Benson wrote:
>> >
>> > 2009/12/30 Bruce Dubbs <address@hidden
>> > <mailto:address@hidden>>
>> >
>> >     Bruce O. Benson wrote:
>> > All contributors can safely, legally add/merge/move stuff there if
>> > desired, delete anything/everything I wrote, add attributions I could
>> > not find, etc.
>> >
>> It's not how it works. For the documentation to be accepted to GNU
>> project contributors have to sign legal papers.
>> Now I'm going to comment on value of manual:
>> "Installation via Package Management" is distribution-specific so it's
>> inappropriate for upstream manual
>> "Building / Installation from Source" is a part of INSTALL and we
>> already have this
>> "Utilities" - description of tools is inappropriate. User doesn't care
>> if it's ELF or text file but how to use them.
>> "Pre-Boot" - is wrong. MBR doesn't point anywhere it's executable code.
>> "grub-rescue" part is wrong too
>> "Lua shell" is part of grub-extras, not grub itself.
>> In whole the manual is vague, contains inappropriate or inexact
>> information.
>> If we merge any part of this manual into bzr we would need to proofread
>> every patch
>
> This is the typical problem of contributing complaints vs. code.

In Vladimir's defense, he contributes lots of code.

Thanks for trying to do the documentation which he hasn't.

All of the above information ought to be findable from the grub online
manual.  Things which aren't part of grub core, such as
distro-specific packaging, are probably well-served by a link to the
package documentation at that distro's site; a link is better than
pretending the greater ecosystem doesn't exist, while avoiding making
the grub project responsible to documenting scripts and package
managers beyond their control.

>
> _______________________________________________
> Grub-devel mailing list
> address@hidden
> http://lists.gnu.org/mailman/listinfo/grub-devel
>
>