From owner-freebsd-current@FreeBSD.ORG Thu Sep 2 10:13:15 2010 Return-Path: Delivered-To: current@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B063A10656EE; Thu, 2 Sep 2010 10:13:15 +0000 (UTC) (envelope-from niclas.zeising@gmail.com) Received: from mxf2.bahnhof.se (mxf2.bahnhof.se [213.80.101.26]) by mx1.freebsd.org (Postfix) with ESMTP id 692688FC19; Thu, 2 Sep 2010 10:13:15 +0000 (UTC) Received: from localhost (mxf2.local [127.0.0.1]) by mxf2-reinject (Postfix) with ESMTP id E36369696A2; Thu, 2 Sep 2010 11:45:58 +0200 (CEST) X-Virus-Scanned: by amavisd-new using ClamAV at bahnhof.se (MXF2) X-Spam-Score: 4.468 X-Spam-Level: **** X-Spam-Status: No, score=4.468 tagged_above=-99 required=5 tests=[DNS_FROM_RFC_POST=1.708, RATWARE_GECKO_BUILD=1.691, SPF_NEUTRAL=1.069] Received: from mxf2.bahnhof.se ([127.0.0.1]) by localhost (mxf2.bahnhof.se [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id wH+DbuV35U8w; Thu, 2 Sep 2010 11:45:53 +0200 (CEST) Received: from [10.32.0.4] (h-90-99.A163.priv.bahnhof.se [79.136.90.99]) by mxf2.bahnhof.se (Postfix) with ESMTP id D983F969685; Thu, 2 Sep 2010 11:45:53 +0200 (CEST) Message-ID: <4C7F724F.2060305@gmail.com> Date: Thu, 02 Sep 2010 11:45:51 +0200 From: Niclas Zeising User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.1; en-US; rv:1.9.2.8) Gecko/20100802 Thunderbird/3.1.2 MIME-Version: 1.0 To: Gabor PALI References: In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: doc@freebsd.org, current@freebsd.org Subject: Re: Call for Documentation Contributors X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Discussions about the use of FreeBSD-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 02 Sep 2010 10:13:15 -0000 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 > [1] 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. > > :g > > [1] http://doc.hu.freebsd.org/ Hi! 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! Best Regards! //Niclas