Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 12 Dec 2002 21:48:44 +0000
From:      Ceri Davies <ceri@FreeBSD.org>
To:        Manohar Singh <sg_manohar@yahoo.com>
Cc:        freebsd-doc@FreeBSD.org
Subject:   Re: documentation (or other) contributions
Message-ID:  <20021212214844.GA10619@submonkey.net>
In-Reply-To: <20021212110103.23394.qmail@web13801.mail.yahoo.com>
References:  <20021212110103.23394.qmail@web13801.mail.yahoo.com>

next in thread | previous in thread | raw e-mail | index | archive | help
On Thu, Dec 12, 2002 at 03:01:03AM -0800, Manohar Singh wrote:

Hi Namohar,

> My name is Manohar Singh, and I would like to
> contribute to the freebsd documentation project.

Wonderful news!

> What is the process to be followed for this ?

The best place to start is usually to think if there's anything in the
existing documentation that's broken, inaccurate, misleading, etc. and
try and make it better.

An even better place to start would be to think of something that you know
*should* be in the documentation, and then document it.

The documentation is currently written in Docbook format (check out the
textproc/docbook-tdg or www.docbook.org for a free copy of the O'Reilly
book Docbook - The Definitive Guide), but it's not a requirement - if you
want to submit stuff in plain text that's ok too; we can mark it up into
Docbook for you if necessary.

Then either post them here, or use send-pr, to get them into the wild.
One of us doc committers will notice it (and if we don't, you can always
mail us again to remind us) and pick it up from there.

Michael Lucas wrote a good article on contributing for OnLamp; it's at
http://www.onlamp.com/pub/a/bsd/2002/01/17/Big_Scary_Daemons.html and
http://www.onlamp.com/pub/a/bsd/2002/01/31/Big_Scary_Daemons.html

Also, there's the FreeBSD Documentation Project Primer at:
http://www.freebsd.org/docproj/index.html

Any questions, just ask!

Thanks for your interest,

Ceri
-- 
For the Dwarf Father, the rune, and the brave!

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20021212214844.GA10619>