Re: Contributing.

[Stein Gjoen <sgjoen@mail.nyx.net>]

Guylhem Aznar wrote:
> 
> Hi,
> 
> Before we post on cola (Stern could you do this?), I think we should
> better explain how people can contribute to the LDP.

I have written up a proposal for the announcement and also
for the man-page intro.ldp which I hope to get some feedback
on here. Too short? Too verbose? Missing info? Please let me know.

Straight off I must admit this is the very first man-page I have
written, based on a zsh man page I found. No doubt it needs
massive rewrite. I also see I got the mailing list wrong...

Anyway:

==(Announcement)===

After a number of restructuring of the Linux Documentation Project (LDP)
we feel ready to serve the Linux community from the new home:
	http://www.linuxdoc.org/

The LDP has collected and produced numerous documents such as
 - guides
 - HOWTOs and mini-HOWTOs
 - FAQs
 - man pages
and more.

All in all the LDP endavours to produce and provide a one-stop source of
information relating to the various aspects of Linux. There is now also
a search engine on the front page to help you locate the documents you
need quickly and efficiently. If you have a question, chances are you
will find what you need here.

These documents are produced for you, the end users. That means if there
is anything in the documents you find unclear, ambiguous or incorrect
you should not hesitate in contacting the author. While the workload of
the author in general is high and cannot be expected to answer specific
problems you may have on your machine, authors are only happy to receive
feedback on the documents.

Likewise, if you feel you have something to contribute or wish to try
your hands as an LDP author you are welcome to contact the LDP coordinator
with your inputs. Remember that new documents are produced all the time
so it is important to contact the LDP before you start writing in order
to eliminate the possibility of duplicate work.

Remember that you do npt have to be on-line to read the HOWTOs, in many
cases these documents are installed with your Linux distribution and can
be found at
	file:///usr/doc/HOWTO	/usr/doc/Howto/

Regards,
   Stein Gjoen

===(intro.ldp)===

.TH "LDP Introduction" "ldp" "January 31, 2000" "LDP"
.SH "NAME"
.'
LDP \- Intro to the Linux Documentation Project, with help, guides and
documents
.' (avoiding a yodl bug)
.\" Yodl file: Zsh/intro.yo
.'
.'
.SH "SYNOPSIS"
.'
The Linux Documenttaion Project, or LDP for short, provides free
documentation,
guides, FAQs, HOWTOs and mini-HOWTOs and man-pages to the Linux community.


.SH "AUTHORS"
.'
.'
The various documents in the LDP archives are maintained by individual
authors, and are listed in the beginning of each HOWTO. If you have
any questions or inputs to a document you are welcome to contact the
authors directly.

.SH "WEB PAGES"
.'
.'
The LDP has not its own dedicated web page on the net, and in addition
the various translations have their own pages, linked from the
main LDP web site at
.'
\fBhttp://www\&.linuxdoc\&.org/\fP


.'
.SH "MAILING LISTS"
.'
.'
LDP has a number of mailing lists, mostly of use for authors:
.PP
.PD 0
.TP
.PD
\fB<ldp\-announce@listserv\&.debian\&.org>\fP
Announcements from the LDP project
.TP
\fB<ldp\-discuss@listserv\&.debian\&.org>\fP
General discussion on the LDP project


.SH "FILES"
.'
.'
Most distributions include the HOWTOs and mini-HOWTOs in the installation
.PD 0
.TP
\fB/usr/doc/\fP             (most documentation is here)
.TP
\fB/usr/doc/HOWTO/\fP       (HOWTO files)
.TP
\fB/usr/doc/HOWTO/mini/\fP  (mini-HOWTO files)
.PD
.'
.SH "SEE ALSO"
.'
\fIman\fP(1)
.' (avoiding a yodl bug)
.' (avoiding a yodl bug)

===(intro.txt)===
LDP Introduction(ldp)                       LDP Introduction(ldp)


NAME
       LDP - Intro to the Linux Documentation Project, with help,
       guides and documents

SYNOPSIS
       The Linux Documenttaion Project, or LDP  for  short,  pro-
       vides  free  documentation, guides, FAQs, HOWTOs and mini-
       HOWTOs and man-pages to the Linux community.



AUTHORS
       The various documents in the LDP archives  are  maintained
       by  individual authors, and are listed in the beginning of
       each HOWTO. If you have any questions or inputs to a docu-
       ment you are welcome to contact the authors directly.


WEB PAGES
       The LDP has not its own dedicated web page on the net, and
       in addition the various translations have their own pages,
       linked  from  the  main  LDP web site at http://www.linux-
       doc.org/



MAILING LISTS
       LDP has a number of  mailing  lists,  mostly  of  use  for
       authors:

       <ldp-announce@listserv.debian.org>
              Announcements from the LDP project

       <ldp-discuss@listserv.debian.org>
              General discussion on the LDP project



FILES
       Most  distributions  include the HOWTOs and mini-HOWTOs in
       the installation
       /usr/doc/             (most documentation is here)
       /usr/doc/HOWTO/       (HOWTO files)
       /usr/doc/HOWTO/mini/  (mini-HOWTO files)

SEE ALSO
       man(1)










LDP                      January 31, 2000                       1
===end===

Regards,
   Stein Gjoen


--  
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org