From owner-freebsd-doc@FreeBSD.ORG Wed Jun 14 16:48:11 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 F2F4016A47B; Wed, 14 Jun 2006 16:48:10 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from pittgoth.com (ns1.pittgoth.com [216.38.206.188]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9F59B43E8C; Wed, 14 Jun 2006 16:44:41 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (ip70-177-190-239.dc.dc.cox.net [70.177.190.239]) (authenticated bits=0) by pittgoth.com (8.13.4/8.13.4) with ESMTP id k5EGkulr098161 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Wed, 14 Jun 2006 12:46:57 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Wed, 14 Jun 2006 12:43:54 -0400 From: Tom Rhodes To: linimon@lonesome.com (Mark Linimon) Message-Id: <20060614124354.4a45d91b.trhodes@FreeBSD.org> In-Reply-To: <20060614074230.GA1221@soaustin.net> References: <20060613223307.GB1074@zaphod.nitro.dk> <20060614074230.GA1221@soaustin.net> X-Mailer: Sylpheed version 1.0.6 (GTK+ 1.2.10; i386-portbld-freebsd7.0) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org, simon@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 16:48:11 -0000 On Wed, 14 Jun 2006 02:42:30 -0500 linimon@lonesome.com (Mark Linimon) wrote: > 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. > Well, 20+ megabytes of space isn't much. And storage space is nice and cheap these days. -- Tom Rhodes