RFC: Delete Manual Debian

Michael Shiloh michael at openmoko.org
Thu Sep 4 07:13:15 CEST 2008


Minh Ha Duong wrote:
>> "Contents of this page is probably old and superseded by this new page :
>> Debian."
>>
>> Someone with more Debian experience than me might go through this page
>> and see if there is anything useful in it, but with an introduction like
>> the above, I think it's pretty safe to delete it as it is.
> 
>   It do not looks like duplicate to me. "Manual" here means "from scratch", as 
> opposed to "Using the installation script". It's important to keep notes on 
> how to do things step by step, otherwise when the script breaks...
> So unless the script is very well documented, I would say it's a 
> paragrap-by-paragraph assessment of 'is this information better said 
> elsewhere', but there is no case for a whole page deletion. The warning and 
> title should be changed to disambiguate "Manual".
> 

Unless it doesn't work, in which case it causes more trouble.

A good (if time-consuming) task would be to take the manual page and use 
it to document the script. since the script is the live document, it is 
the most likely to be kept up to date.

Assuming of course that we have write access to wherever that script is 
stored.

M



More information about the documentation mailing list