From owner-freebsd-doc@FreeBSD.ORG Wed Dec 10 07:42:28 2003 Return-Path: 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 A479C16A4CE; Wed, 10 Dec 2003 07:42:28 -0800 (PST) Received: from mail.droso.net (koala.droso.net [193.162.142.74]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3FC9543D2D; Wed, 10 Dec 2003 07:42:25 -0800 (PST) (envelope-from erwin@mail.droso.net) Received: by mail.droso.net (Postfix, from userid 1001) id 4EDCE2282C; Wed, 10 Dec 2003 16:42:23 +0100 (CET) Date: Wed, 10 Dec 2003 16:42:23 +0100 From: Erwin Lansing To: doc@FreeBSD.org Message-ID: <20031210154223.GD6165@droso.net> Mail-Followup-To: doc@FreeBSD.org, portmgr@FreeBSD.org References: <20031203124353.GD82966@droso.net> <20031203133557.GA23226@electra.cse.Buffalo.EDU> <20031203150958.GC72102@droso.net> <20031203184112.GA53286@intruder.kitchenlab.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="NDin8bjvE/0mNLFQ" Content-Disposition: inline In-Reply-To: <20031203184112.GA53286@intruder.kitchenlab.org> User-Agent: Mutt/1.4.1i X-Operating-System: FreeBSD/i386 5.1-CURRENT cc: portmgr@FreeBSD.org Subject: Re: Documentation of major changes to the ports collection X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Dec 2003 15:42:28 -0000 --NDin8bjvE/0mNLFQ Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, Dec 03, 2003 at 10:41:12AM -0800, Bruce A. Mah wrote: > If memory serves me right, Erwin Lansing wrote: >=20 > > Although I'm all that happy about starting two new documents, I keep > > running into problems with how to combine the best of both worlds > > and perhaps the best would be both. One plaintext UPDATING-style where > > all ports-committers can add items for developers to and one relnotes-s= tyle, > > which rotates at each release and is published at the website more orie= nted > > at users. >=20 > This might be a good approach. The second document could actually be > implemented as a part of the existing release notes, since it's tied > fairly strongly to particular releases of the base system. >=20 Judging from the overwhelming respons, people agree that this is the way to go. At least I like it :) Now I've just have to find an empty hour or so to write up some guidelines for the top of /usr/ports/CHANGES, which I'd like to create with portmgr's permission and write a section for the porter's handbook. Bruce, would you mind working with me on adding a section to the release notes (after the release of 5.2) ? -erwin --=20 _._ _,-'""`-._ Erwin Lansing (,-.`._,'( |\`-/| erwin@lansing.dk http://droso.org `-.-' \ )-`( , o o) erwin@FreeBSD.org -bf- `- \`_`"'- --NDin8bjvE/0mNLFQ Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (FreeBSD) iD8DBQE/1z7fqy9aWxUlaZARAlRBAKCCj3Ps/dozqaBri2kuqtQZfcAsgwCeNpeY SsOxnx5V6MU8whXHaQwgkCI= =noT5 -----END PGP SIGNATURE----- --NDin8bjvE/0mNLFQ--