Call for Documentation Contributors
niclas.zeising at gmail.com
Thu Sep 2 10:13:15 UTC 2010
On 2010-09-02 00:46, Gabor PALI wrote:
> Hello there,
> I am looking for volunteers who are interested in writing
> documentation, i.e. working with the FreeBSD Handbook and the
> documentation set. Many of our great documentation writers have
> decided to retire from their work over the last years, which means the
> FreeBSD Documentation Project is in need of talented, skilled,
> determined, and ambitious people who would help to maintain the
> tradition of producing high quality documentation for the FreeBSD
> operating system.
> The documentation set is prepared in DocBook that might seem a bit
> complicated at first sight, but I can assure you it can be learned
> quickly. All you need is good writing skills in English, some
> knowledge of FreeBSD systems, and willingness to learn even more about
> them. To coordinate and encourage the efforts, I have created a site
>  called "The FreeBSD Contributor's Documentation Project" that
> contains the necessary information. Note that there are many ways of
> contribution: you can comment open Problem Reports or write patches
> (by using Mercurial Queues for example), etc. depending on your free
> time. I can help with anything at the regular weekly IRC meetings,
> and you can contact me via email directly any time, and hopefully
> other documentation developers will also join me.
> Thank you for any help in advance.
>  http://doc.hu.freebsd.org/
Just a nitpick, would it be possible to move that site to the wiki,
where most other stuff related to FreeBSD development is? It's not meant
as critique towards your work, just a suggestion.
Also, a list of open tasks would probably be valuable. For instance a
list where people who find errors or discrepancies in the docs can add
them so other people find them and can work on them. I know this is what
the PR system is built for, but the PR system might be a bid cumbersome
for just making annotations and stuff like that.
Just some suggestions on how to make this flow better. Hopefully I will
have some time to actually do some of the work involved too. :)
Keep up the good work!
More information about the freebsd-current