Date: Sun, 22 Mar 2015 19:28:19 +0000 (UTC) From: Allan Jude <allanjude@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46364 - head/en_US.ISO8859-1/articles/problem-reports Message-ID: <201503221928.t2MJSJ0B067520@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: allanjude Date: Sun Mar 22 19:28:18 2015 New Revision: 46364 URL: https://svnweb.freebsd.org/changeset/doc/46364 Log: Update PR article to ask people not to submit PRs about outdated ports PR: 194721 Differential Revision: https://reviews.freebsd.org/D2092 Submitted by: marino (original) Reviewed by: wblock, Andrew Berg (earlier version) Approved by: bcr (mentor) Sponsored by: ScaleEngine Inc. Modified: head/en_US.ISO8859-1/articles/problem-reports/article.xml Modified: head/en_US.ISO8859-1/articles/problem-reports/article.xml ============================================================================== --- head/en_US.ISO8859-1/articles/problem-reports/article.xml Sun Mar 22 19:26:11 2015 (r46363) +++ head/en_US.ISO8859-1/articles/problem-reports/article.xml Sun Mar 22 19:28:18 2015 (r46364) @@ -101,30 +101,29 @@ for an answer, consider posing the question to the &a.questions;.</para> - <para>Some cases where it may be appropriate to submit a problem - report about something that is not a bug are:</para> + <para>Consider these factors when submitting PRs about ports or + other software that is not part of &os; itself:</para> <itemizedlist> <listitem> - <para>Notification of updates to externally maintained - software (such as ports or software in the contrib/ - directory).</para> + <para>Please do not submit problem reports that simply state + that a newer version of an application is available. Ports + maintainers are automatically notified by + <application>portscout</application> when a new version of + an application becomes available. Actual patches to update + a port to the latest version are welcome.</para> + </listitem> + <listitem> <para>For unmaintained ports (<varname>MAINTAINER</varname> - contains <literal>ports@FreeBSD.org</literal>), such update - notifications might get picked up by an interested - committer, or you might be asked to provide a patch to - update the port; providing it upfront will greatly improve - your chances that the port will get updated in a timely - manner.</para> - - <para>If the port is maintained, PRs announcing new upstream - releases are usually not very useful since they generate - supplementary work for the committers, and the maintainer - likely knows already there is a new version, they have - probably worked with the developers on it, they are probably - testing to see there is no regression, etc.</para> + is <literal>ports@FreeBSD.org</literal>), + a PR without an included patch is unlikely to get picked up + by a committer. To become the maintainer of an + unmaintained port, submit a PR with the request (patch + preferred but not required).</para> + </listitem> + <listitem> <para>In either case, following the process described in <link xlink:href="&url.books.porters-handbook;/port-upgrading.html">Porter's Handbook</link> will yield the best results. (You might
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201503221928.t2MJSJ0B067520>