From owner-freebsd-current@FreeBSD.ORG Thu Sep 2 06:34:05 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 BD7E310656FD; Thu, 2 Sep 2010 06:34:05 +0000 (UTC) (envelope-from m.e.sanliturk@gmail.com) Received: from mail-qy0-f182.google.com (mail-qy0-f182.google.com [209.85.216.182]) by mx1.freebsd.org (Postfix) with ESMTP id 3D9B38FC0C; Thu, 2 Sep 2010 06:34:04 +0000 (UTC) Received: by qyk4 with SMTP id 4so199987qyk.13 for ; Wed, 01 Sep 2010 23:34:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:received:in-reply-to :references:date:message-id:subject:from:to:cc:content-type; bh=uR8j2MS+heGyugP5QOgANj5UqUU9R06oXdCzSqjKREE=; b=IYAH3QReDNasgoBIaCewCGG3K3hrL+3pUuG2aZ3foZuLNNhn0+JxwWKgzMg/leyxn3 sTDU89YldgTXY1Zcu1CmLxdVo+zyqRWByeBTXpLpLqWnW5IY6bGJ58Lg8pZKmxIv1dqG oxZXqJSGAGMA9/xIyeh8+9aQhihJgGpd2H6tc= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; b=QeVJh0Ys7x7uxMCokkMLj/c5X9aOVeK8k3ahRGdBsxRXj3TskrMV3i9mEQFKPEz9iK 4UKJRYZw6kUIUHQ7przdxGP+2wvEXigo2/tX9sezMzQdoVTiV3zBOiVaGtA/aaUnoUGd z2057pqJOrYg3p1SyNdoMjSqP/oDZ0mbbDDDM= MIME-Version: 1.0 Received: by 10.229.189.211 with SMTP id df19mr6749274qcb.146.1283407533860; Wed, 01 Sep 2010 23:05:33 -0700 (PDT) Received: by 10.220.91.209 with HTTP; Wed, 1 Sep 2010 23:05:33 -0700 (PDT) In-Reply-To: References: Date: Thu, 2 Sep 2010 02:05:33 -0400 Message-ID: From: Mehmet Erol Sanliturk To: Gabor PALI Content-Type: text/plain; charset=UTF-8 X-Content-Filtered-By: Mailman/MimeDel 2.1.5 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 06:34:05 -0000 On Wed, Sep 1, 2010 at 6:46 PM, 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/ 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 distributions . 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 identify her/his suggestion whether it is contrary to her/his unused distribution . Thank you very much . Mehmet Erol Sanliturk