Call for Documentation Contributors
Mehmet Erol Sanliturk
m.e.sanliturk at gmail.com
Thu Sep 2 06:34:05 UTC 2010
On Wed, Sep 1, 2010 at 6:46 PM, Gabor PALI <pgj at freebsd.org> 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/
I want to repeat my suggestion once more :
Please separate Handbook with respect to distributions , i.e. , maintain a
different Handbook for each distribution . I think , this is more easier to
maintain a combined Handbook . A combined Handbook is giving also an
impression that the both distinct distributions are the SAME . Then what is
the difference between distributions 7.3 and 8.1 ? Personally I do NOT have
any idea about differences , because up to now I did not see such a document
associated with distributions .
The combined Handbook is making it very difficult to make any improvement
suggestions , because it requires knowledge of related two distinct
For example , the current Handbook is about Release 7.3 and 8.1 . If a
person is using 8.x series , and NOT 7.x series will be in difficulty to
suggestion whether it is contrary to her/his unused distribution .
Thank you very much .
Mehmet Erol Sanliturk
More information about the freebsd-doc