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

Re: Install manual organization




Chris Tillman wrote:

> Here's my thinking about re-organization the manual along the lines
> you proposed. We'll need much less space to talk about installation
> source options without a base tarball or floppies.
>
> Installing Debian GNU/Linux 2.2 For PowerPC
>
> Contents
>
> 1 Welcome to Debian
>
> 1.1 What is Debian?
> 1.2 What is GNU/Linux?
> 1.3 What is Debian GNU/Linux?
> 1.4 What is Debian GNU/Hurd?
> 1.5 Getting Debian
> 1.6 Getting the Newest Version of This Document
> 1.7 Organization of This Document
> 1.8 WARNING: This Document Has Known Problems
> 1.9 About Copyrights and Software Licenses
>

Hello Chris,
  nice that youre working on docs,
  i send you a few thoughts, hope you like them.

I think the document should start with chapter 0 : "Welcome to this
document".
  contents, warning about document problems, foreword, getting newest
version,
  indication of copyright of document and purpose of document could be
(part of) this.
  maybe some words about or from the authors ?

Apart from this,
  for a document containing section "getting debian",
  chapter title "Welcome to Debian" seems slightly premature.

GNU/Linux : i think it should be Linux/GNU/X
  

> 2 System Requirements

/snip

> delete ->  4.6 Partitioning Prior to Installation (we recommend using Debian partitioning tools)

  i really dont know, but, would defragmenting be advantageous ?

> 7.6 ``Partition a Hard Disk''

/snip

8.1 If You Are New to Unix

  shouldnt that be "Linux" ?

/snip

  have fun, 
  Siward

____________________________________________________________________________

(c) Linus is a registered name of "Linux" Torvalds



Reply to: