From owner-freebsd-doc@FreeBSD.ORG Wed Jun 14 07:42: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 C637416A41B; Wed, 14 Jun 2006 07:42:31 +0000 (UTC) (envelope-from linimon@lonesome.com) Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8EF4943D45; Wed, 14 Jun 2006 07:42:31 +0000 (GMT) (envelope-from linimon@lonesome.com) Received: by mail.soaustin.net (Postfix, from userid 502) id 059022EE2; Wed, 14 Jun 2006 02:42:30 -0500 (CDT) Date: Wed, 14 Jun 2006 02:42:30 -0500 To: "Simon L. Nielsen" Message-ID: <20060614074230.GA1221@soaustin.net> References: <20060613223307.GB1074@zaphod.nitro.dk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20060613223307.GB1074@zaphod.nitro.dk> User-Agent: Mutt/1.5.9i From: linimon@lonesome.com (Mark Linimon) Cc: freebsd-doc@freebsd.org Subject: Re: Split and cleanup of Porters Handbook 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, 14 Jun 2006 07:42:31 -0000 I'm quite concerned that it will be more difficult to figure out when new text was introduced, or old text was changed. There have been several times in the past that I have tried to find out "why is XYZ being done, is that just something from the old days? When was it introduced?" and have been unable to, due to the fact that years ago there was some kind of repocopy and split (off from the Handbook, perhaps?) and it's so obscure that it's just not possible to track it all down. I have had some ideas in the past on how to reorg the handbook in terms of "policies (which will be enforced) vs. best practices (which is what portmgr recommends", and further split the thing up into a Ports Users' Guide vs. what really ought to be in the "Porter's Handbook", but I have been far enough away from doc work for a while that I think I have to admit I won't get around to this anytime in the next month or two. mcl