From owner-freebsd-doc@FreeBSD.ORG Sat Sep 23 15:23:31 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 4C3B916A47B for ; Sat, 23 Sep 2006 15:23:31 +0000 (UTC) (envelope-from joel@FreeBSD.org) Received: from av12-2-sn2.hy.skanova.net (av12-2-sn2.hy.skanova.net [81.228.8.186]) by mx1.FreeBSD.org (Postfix) with ESMTP id 80D0B43D5A for ; Sat, 23 Sep 2006 15:23:30 +0000 (GMT) (envelope-from joel@FreeBSD.org) Received: by av12-2-sn2.hy.skanova.net (Postfix, from userid 502) id 2A19E3ABA3; Sat, 23 Sep 2006 17:23:28 +0200 (CEST) Received: from smtp4-1-sn2.hy.skanova.net (smtp4-1-sn2.hy.skanova.net [81.228.8.92]) by av12-2-sn2.hy.skanova.net (Postfix) with ESMTP id 7EB6E3AB89; Sat, 23 Sep 2006 17:21:41 +0200 (CEST) Received: from dude.automatvapen.se (81-229-112-193-no21.tbcn.telia.com [81.229.112.193]) by smtp4-1-sn2.hy.skanova.net (Postfix) with ESMTP id 836BB37E56; Sat, 23 Sep 2006 17:21:40 +0200 (CEST) From: Joel Dahl To: Paul Wilson In-Reply-To: <3c3d11cf0609180443y45d1e3d9p8d3993588cdc89c2@mail.gmail.com> References: <3c3d11cf0609130258s5ebf8274q18acf31a83b403a7@mail.gmail.com> <1158144023.670.36.camel@localhost> <450B42FD.7070508@dwlabs.ca> <3c3d11cf0609180443y45d1e3d9p8d3993588cdc89c2@mail.gmail.com> Content-Type: text/plain Date: Sat, 23 Sep 2006 17:21:40 +0200 Message-Id: <1159024900.674.15.camel@localhost> Mime-Version: 1.0 X-Mailer: Evolution 2.6.1 FreeBSD GNOME Team Port Content-Transfer-Encoding: 7bit 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: Sat, 23 Sep 2006 15:23:31 -0000 On Mon, 2006-09-18 at 12:43 +0100, Paul Wilson wrote: > On 16/09/06, Duane Whitty wrote: > I intend to work on this one way or another. Hopefully it > will happen in a way that makes it readily available to the > wider FreeBSD developer community. I can host a server and > docs if necessary but it sounds like the Perforce repo > already running would be ideal. I'll have to install the > client and come up to speed on using it but I don't > anticipate it being a problem. > > What's the next move then? I'm eager to get the ball rolling :) Sorry for the delay[*]. I've discussed this briefly with a couple of doc committers and we're a bit unsure about how to proceed. My suggestion is that you (Paul and Duane) do something like this: 1. Start out by defining what areas you would like to work on, this way it'll be easier for us to know what we can expect. 2. Work together in some way, and keep your work synchronized. 3. Submit patches to doc@, and CC hackers@ or arch@ (but not both!) if you need some clever kernel hacker to review your work. Try to send small incremental patches, since it will be a lot easier for us to review and commit them that way. PR's may also be a good idea. If all this becomes a major PITA to handle, maybe we can discuss setting up p4 accounts etc. I'm very interested in getting the ball rolling, but I'd like to see some results (patches etc) before someone sets you up with p4 accounts. You would do the project a big favor if you are able to finish this project, and I am very much looking forward to start reviewing your patches. The Arch handbook has been lacking in content for far too long now. [*] /me kicks everyone in CVSROOT-doc/access. Am I the only interested in docs these days? What could possibly be more interesting then doc discussions? ;-) -- Joel