Re: FAQ bug

[Yoshinori K. Okuji]

All I understand is that there is no way to make everybody happy. I
devoted myself to the manual quite seriously, because the manual was
very sparse, and many users complained that it was not friendly for
newbies. So I prepended tutorials and an overview. And, now you
complain that it isn't suitable for experts. *sigh*

If my understand is correct, most users are not experts. So I believe
that it is basically the Right Thing to target on newbies. Experts
should know how to skip over unnecessary parts of a manual (for them),
anyway.

As you know, what one knows already and what she wants to know are
different (often dramatically) from person to person. So it is really
difficult to determine what should be mentioned first of all and what
should be said afterwards. I now realize that it may be wrong to put
some sections (such as "History") in the chapter "Introduction", but
what's wrong with others? The section "Overview" describes the "big
picture" (I don't know if what I call "big picture" is the same as
yours), and the following chapters describe the details. "Naming
convention" is necessary at that point, because you need to understand
the rule to install GRUB.

Okuji