[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: [i10n] Installation Manual Updates

On Mon, May 10, 2004 at 11:33:05PM +0200, Frans Pop wrote:
> I agree with Miroslav here. Note that the manual is also likely to be included 
> as a printed document by some Debian CD vendors. I think especially for this 
> use it is very valuable information. And the current text is generally well 
> written.
> The manual is mainly focussed at Debian newbies. I like the idea of giving 
> them some background info on just what they have downloaded/purchased, 
> especially as Debian is not your run of the mill, pay through your nose piece 
> of software.

Here's an alternate approach that I think makes more sense. Rather than
give the users a didactic lecture at the beginning of the manual (which
most will never read) instead sprinkle the ideas of freedom throughout
the manual. "Debian's commitment to freedom has allowed it to be ported
to multiple architectures. You can find out about these at foo." Things
like that. This way, we can emphasize to people throughout why things
like Freedom are good for them, and why these are the things that make
Debian what they are. Now that I think about it, Gentoo's manual is
actually written this way as well, emphasizing choice and flexibility

I'll try and write these as I go, and I'll make a run-through once I'm
done with the major edits to add any more in. Hopefully it'll be enough
that we can safely remove the majority of Chapter 1 and still retain the
spirit of what it tries to accomplish.


> Please keep these sections in for now. At this stage I think it is more 
> important to get the 'real' content up to date with the installer.

I won't remove any of these sections until later, when things are

 - David Nusinow

Reply to: