On 3/3/07, Ciaran McCreesh <[EMAIL PROTECTED]> wrote:
I asked for this approach back when the handbook was first created. It was rejected by the docs team for being "too complicated to maintain". Following Sven's (I think...) suggestion, I instead ported the quick install guide (which is one page, and doesn't go off on lots of weird tangents) to the archs upon which I was working at the time.
Yes, that was my request and I was told that this was the plan of attack, but the end result looked nothing like this. Just to be clear, I think the *official* documentation should be simple, with a linear path and non-intrusive links for non-standard stuff, and should fit on a single (Web) page. I don't think that a quick install guide solves the problem. (I know *you're* not saying it does, just pointing it out...) The official documentation should be incredibly efficient to use, eliminating the need for a quick install guide. -Daniel -- [email protected] mailing list
