From owner-freebsd-doc@FreeBSD.ORG  Sat May  7 07:20:07 2005
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 6E56F16A4D8
	for <freebsd-doc@hub.freebsd.org>;
	Sat,  7 May 2005 07:20:07 +0000 (GMT)
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 5610043D2F
	for <freebsd-doc@hub.freebsd.org>;
	Sat,  7 May 2005 07:20:07 +0000 (GMT)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.13.3/8.13.3) with ESMTP id j477K7rB054242
	for <freebsd-doc@freefall.freebsd.org>; Sat, 7 May 2005 07:20:07 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j477K7gE054241;
	Sat, 7 May 2005 07:20:07 GMT
	(envelope-from gnats)
Date: Sat, 7 May 2005 07:20:07 GMT
Message-Id: <200505070720.j477K7gE054241@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: David Adam <zanchey@ucc.gu.uwa.edu.au>
Subject: Re: docs/80681: articles/problem-reports: don't tell people they
 should sumbit a PR each time they see an outdated port
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
Reply-To: David Adam <zanchey@ucc.gu.uwa.edu.au>
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 07 May 2005 07:20:07 -0000

The following reply was made to PR docs/80681; it has been noted by GNATS.

From: David Adam <zanchey@ucc.gu.uwa.edu.au>
To: Ion-Mihai Tetcu <itetcu@people.tecnik93.com>
Cc: FreeBSD gnats submit <FreeBSD-gnats-submit@FreeBSD.org>,
	freebsd-doc@FreeBSD.org
Subject: Re: docs/80681: articles/problem-reports: don't tell people they
 should sumbit a PR each time they see an outdated port
Date: Sat, 7 May 2005 15:10:12 +0800 (WST)

 > > Why not just "If you are reporting a new version of a port, try to contact
 > > the port's maintainer first."?
 >
 > So that I don't see PR but post on ports@ ? Well, it will be an
 > improvement, at least no one will have to close them.
 
 I have two primary problems with the proposed patch
 - It's poorly written. This can be fixed.
 - The general message that it gives is not one I think is beneficial. We
 should be trying to remove barriers for people to report problems, not
 institute them.
 
 I can understand that you want to reduce the amount of waffle in the PR
 database, but I think your proposed change is too complicated and too
 negative.
 
 Now, I am not a committer nor subscribed to ports@, but surely hitting the
 Delete key once or twice a week more often is not that huge a price to
 pay?
 
 I propose that this patch be shortened to:
 
 --- article.sgml.orig   2005-01-15 10:16:42.000000000 +0800
 +++ article.sgml        2005-05-07 15:07:06.622424000 +0800
 @@ -106,7 +106,8 @@
         <para>Notification of updates to externally maintained
           software (mainly ports, but also externally maintained base
           system components such as BIND or various GNU
 -         utilities).</para>
 +         utilities). If you are reporting a new version of a
 +         port, try contacting the port's maintainer first.</para>
        </listitem>
      </itemizedlist>
 
 David Adam
 zanchey@ucc.gu.uwa.edu.au