From owner-freebsd-doc@FreeBSD.ORG Thu Sep 22 02:03:49 2005 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 AA4A616A41F for ; Thu, 22 Sep 2005 02:03:49 +0000 (GMT) (envelope-from keramida@ceid.upatras.gr) Received: from kane.otenet.gr (kane.otenet.gr [195.170.0.95]) by mx1.FreeBSD.org (Postfix) with ESMTP id E2B7443D45 for ; Thu, 22 Sep 2005 02:03:47 +0000 (GMT) (envelope-from keramida@ceid.upatras.gr) Received: from flame.pc (patr530-a036.otenet.gr [212.205.215.36]) by kane.otenet.gr (8.13.4/8.13.4/Debian-1) with ESMTP id j8M23hrL017687; Thu, 22 Sep 2005 05:03:44 +0300 Received: from flame.pc (flame [127.0.0.1]) by flame.pc (8.13.4/8.13.4) with ESMTP id j8M23IR0001448; Thu, 22 Sep 2005 05:03:18 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Received: (from keramida@localhost) by flame.pc (8.13.4/8.13.4/Submit) id j8M23F4L001447; Thu, 22 Sep 2005 05:03:15 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Date: Thu, 22 Sep 2005 05:03:13 +0300 From: Giorgos Keramidas To: Mark Linimon Message-ID: <20050922020313.GA1376@flame.pc> References: <200509211504.46861.josh@tcbug.org> <20050922002217.GA24457@soaustin.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20050922002217.GA24457@soaustin.net> Cc: freebsd-doc@freebsd.org Subject: Re: Proposed addition to the handbook http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html 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: Thu, 22 Sep 2005 02:03:49 -0000 On 2005-09-21 19:22, Mark Linimon wrote: >On Wed, Sep 21, 2005 at 03:04:46PM -0500, Josh Paetzel wrote: >> Another question would be if this would go beyond the 'basic >> instructions' statement at the top of the page. > > There is a lot of information that is IMHO missing on the various > strategies to keep up with and use the Ports Collection (portupgrade, > cvsup, and portsnap all deserve their own sections). There is a > little bit at the end of the Porter's Handbook but IMHO the PH is too > large anyways, and ought to be reoriented into just something targeted > at maintainers. > > What do people think: should this information be in some kind of > expanded section in the Handbook? Or a separate Article? I'm always in favor of splitting the documentation to at least three types of documents: - Administrator documentation - End-user documentation - Developer documentation So, I'm in favor of keeping this out of the Porter's Handbook, which should orbit ever closer to the third type (developer docs). - Giorgos