From owner-freebsd-doc@FreeBSD.ORG Wed Sep 13 12:44:50 2006 Return-Path: X-Original-To: Freebsd-doc@freebsd.org Delivered-To: Freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C822716A407 for ; Wed, 13 Sep 2006 12:44:50 +0000 (UTC) (envelope-from paulalexwilson@gmail.com) Received: from wx-out-0506.google.com (wx-out-0506.google.com [66.249.82.238]) by mx1.FreeBSD.org (Postfix) with ESMTP id A621043D5F for ; Wed, 13 Sep 2006 12:44:47 +0000 (GMT) (envelope-from paulalexwilson@gmail.com) Received: by wx-out-0506.google.com with SMTP id i27so2383078wxd for ; Wed, 13 Sep 2006 05:44:46 -0700 (PDT) DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=beta; d=gmail.com; h=received:message-id:date:from:to:subject:cc:in-reply-to:mime-version:content-type:references; b=k7x59/t/F4dtas4aTYOHjLExlhkGZ5rswfnShv/2N9HWy0klG4Oyh3RtGV1FUByD1x0dHlkEKon0yQGEOdNQfh9qK82W/1QyeqyhL33yEB8uQtr7tafZmCFQyTP4bz60+CqIcDRxcX6rq93aWqjYIuJWYCqCEUf7mhq9Reyfr7s= Received: by 10.70.37.12 with SMTP id k12mr10416242wxk; Wed, 13 Sep 2006 05:44:42 -0700 (PDT) Received: by 10.70.89.11 with HTTP; Wed, 13 Sep 2006 05:44:42 -0700 (PDT) Message-ID: <3c3d11cf0609130544n6c553f25m3f1f526f87c395c6@mail.gmail.com> Date: Wed, 13 Sep 2006 13:44:42 +0100 From: "Paul Wilson" To: "Joel Dahl" In-Reply-To: <1158144023.670.36.camel@localhost> MIME-Version: 1.0 References: <3c3d11cf0609130258s5ebf8274q18acf31a83b403a7@mail.gmail.com> <1158144023.670.36.camel@localhost> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Content-Disposition: inline X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Cc: Freebsd-doc@freebsd.org Subject: Re: man pages and handbooks X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 13 Sep 2006 12:44:50 -0000 On 13/09/06, Joel Dahl wrote: > > I'm sure we can come up with a solution if you (Paul and Duane) really > are interested in doing this work. Perforce could be a good solution, > especially since our kernel developers actively read p4 diffs and could > comment on your progress. Also, submitting your work back to FreeBSD > and syncing with the doc repository should be easy if you use p4. The > problem with our perforce repository is that it's quite hidden... I am certainly interested, perforce would be ideal. The Architecture handbook, the Developers handbook, manual pages and the > general lack of documentation have been the target for many complaints > during the years. It is quite hard to get familiar with our kernel > infrastructure, and it's not always obvious who to ask when new > questions arise. The general rule though is that the arch@ and hackers@ > mailing lists should be your first stop when you need to get in touch > with someone that has the right kernel knowledge. As someone trying to acquaint himself with the kernel infrastructure, I can attest to this. This is certainly something I would like to be involved in because I feel that the project would be far more attractive if its documentation was well maintained. Besides I think it would be a great way to learn more. The project will loose future developers if the lack of documentation is > a too big obstacle, and this will surely hurt the project in the end, > but I'm sure we can arrange something or develop a solution if you > really are interested in fixing this major PITA. > Absolutely. Speaking for myself, I am interested in working on this. I have an amount of spare time available for the next year that would be well spent on a project like this. Paul