discuss: Net-HOWTO (was Re: Bug#178233: doc-linux-text: Net-HOWTO corruption)
Subject:
Re: Net-HOWTO (was Re: Bug#178233: doc-linux-text: Net-HOWTO corruption)
From:
David Lawyer ####@####.####
Date:
21 Sep 2004 23:43:15 -0000
Message-Id: <20040921234743.GF1178@davespc>
On Tue, Sep 21, 2004 at 12:14:26AM -0500, ####@####.#### wrote:
> I studied the complete document yesteday and I feel that I could be of
> help in reviewing it.
>
> I see that it is a very big document and focuses on Kernel 2.2 only, the
> revision should focus on Kernel 2.4 and 2.6.
> Apart from this few pages where supported hardware list is presented in
> the documents,a link to Linux Hardware Compatiblity list
> Would be better.
>
> - Commands illustrated is to be corrected.
> - At few places where man page details are explained could be replaced
> with fewer necessary information(after discussion) and then direct the
>
> If I be allowed, I would like to take up the document and work on it. I
> feel that it would take me approximately 1 OR 2 months.
Sounds good, but see the next paragraphs. For a simple alternative to
DocBook markup see my mini howto: Howtos-with-LinuxDoc. The LinuxDoc
format is much easier to learn and use but is technically inferior to
DocBook. The url is
http://www.ibiblio.org/pub/Linux/docs/HOWTO/other-formats/html_single/Howtos-with-LinuxDoc.html
The Network-Overview-HOWTO is also obsolete. If you work on the
Net-HOWTO it will be a major revision and involve a lot of work.
There's also a Network-Administrator's Guide. The major distributions
likely handle network configuration differently.
I just counted and there are 99 LDP-HOWTOs under "Networking". A few of
these may be in the wrong catgory but there's still a lot of them. See
the HOWTO index. I think the Net-HOWTO should have something to say
about each of them (at least list them), including mentioning ones that
are obsolete if feasible. Or you could try to contact authors and try
to get them updated. Just brief reviewing all these HOWTOs and trying
to get some authors to update would be a big help. For this I would
suggest a sampling type of review where you just take samples of parts
of them. So if you would rather review than update, that's another way
to help.
David Lawyer
