os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Bring this article up to date:

Browse source 
- there is no 'jail' category in GNATS.
 - try to clarify which assignees are mailing lists, and which are
   mail aliases.
 - sysinstall(8) bugs no longer go to freebsd-qa, and haven't for
   a long time.  Just use freebsd-bugs.
 - add entries for autotools, doceng, gecko, hamradio, mono, freebsd-ruby,
   secteam, vbox, xen
 - I found it was no longer necessary to assign junk PRs to anyone in
   particular to move them out of the way, so eliminate that step.

Hat:		bugmeister
This commit is contained in:
Mark Linimon 2010-01-30 22:51:48 +00:00
parent cf5068ab40
commit f54ba8fba6
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=35280
1 changed files with 143 additions and 20 deletions

163
en_US.ISO8859-1/articles/pr-guidelines/article.sgml
View file

@ -292,7 +292,7 @@
<row>
<entry>architecture-specific</entry>
<entry>alpha, amd64, arm, i386, ia64, powerpc, sparc64</entry>
<entry>alpha, amd64, arm, i386, ia64, powerpc, sparc64, sun4v</entry>
<entry>freebsd-<replaceable>arch</replaceable></entry>
</row>
@ -324,6 +324,7 @@
<entry>Type</entry>
<entry>Categories</entry>
<entry>Default Assignee</entry>
<entry>Assignee Type</entry>
</row>
</thead>
@ -332,36 +333,35 @@
<entry>advocacy efforts</entry>
<entry>advocacy</entry>
<entry>freebsd-advocacy</entry>
</row>
<row>
<entry>&man.jail.8; subsystem</entry>
<entry>jail</entry>
<entry>freebsd-jail</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>&java.virtual.machine; problems</entry>
<entry>java</entry>
<entry>freebsd-java</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>standards compliance</entry>
<entry>standards</entry>
<entry>freebsd-standards</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>threading libraries</entry>
<entry>threads</entry>
<entry>freebsd-threads</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>&man.usb.4; subsystem</entry>
<entry>usb</entry>
<entry>freebsd-usb</entry>
<entry>mailing list</entry>
</row>
</tbody>
</table>
@ -383,38 +383,41 @@
<note>
<para>Here is a sample list of such entities; it is probably
not complete. In some cases, entries that have the short form are
<emphasis>aliases</emphasis>, not mailing lists.</para>
not complete.</para>
</note>
<table id=common-assignees-base>
<title>Common Assignees &mdash; base system</title>
<tgroup cols="3">
<tgroup cols="4">
<thead>
<row>
<entry>Type</entry>
<entry>Suggested Category</entry>
<entry>Suggested Assignee</entry>
<entry>Assignee Type</entry>
</row>
</thead>
<tbody>
<row>
<entry>problem specific to the &arm; architecture</entry>
<entry>kern</entry>
<entry>arm</entry>
<entry>freebsd-arm</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>problem specific to the &mips; architecture</entry>
<entry>kern</entry>
<entry>freebsd-mips</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>problem specific to the &powerpc; architecture</entry>
<entry>kern</entry>
<entry>freebsd-ppc</entry>
<entry>mailing list</entry>
</row>
<row>
@ -422,6 +425,7 @@
Management (&man.acpi.4;)</entry>
<entry>kern</entry>
<entry>freebsd-acpi</entry>
<entry>mailing list</entry>
</row>
<row>
@ -429,6 +433,7 @@
drivers</entry>
<entry>kern</entry>
<entry>freebsd-atm</entry>
<entry>mailing list</entry>
</row>
<row>
@ -436,30 +441,35 @@
systems (e.g., NanoBSD/PicoBSD/FreeBSD-arm)</entry>
<entry>kern</entry>
<entry>freebsd-embedded</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>problem with &firewire; drivers</entry>
<entry>kern</entry>
<entry>freebsd-firewire</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>problem with the filesystem code</entry>
<entry>kern</entry>
<entry>freebsd-fs</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>problem with the &man.geom.4; subsystem</entry>
<entry>kern</entry>
<entry>freebsd-geom</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>problem with the &man.ipfw.4; subsystem</entry>
<entry>kern</entry>
<entry>freebsd-ipfw</entry>
<entry>mailing list</entry>
</row>
<row>
@ -467,42 +477,56 @@
(ISDN) drivers</entry>
<entry>kern</entry>
<entry>freebsd-isdn</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>&man.jail.8; subsystem</entry>
<entry>kern</entry>
<entry>freebsd-jail</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>problem with &linux; or SVR4 emulation</entry>
<entry>kern</entry>
<entry>freebsd-emulation</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>problem with the networking stack</entry>
<entry>kern</entry>
<entry>freebsd-net</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>problem with the &man.pf.4; subsystem</entry>
<entry>kern</entry>
<entry>freebsd-pf</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>problem with the &man.scsi.4; subsystem</entry>
<entry>kern</entry>
<entry>freebsd-scsi</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>problem with the &man.sound.4; subsystem</entry>
<entry>kern</entry>
<entry>freebsd-multimedia</entry>
<entry>alias</entry>
</row>
<row>
<entry>problem with &man.sysinstall.8;</entry>
<entry>bin</entry>
<entry>freebsd-qa</entry>
<entry>freebsd-bugs (<emphasis>not</emphasis> freebsd-qa)</entry>
<entry>mailing list</entry>
</row>
<row>
@ -510,18 +534,27 @@
(&man.rc.8;)</entry>
<entry>kern</entry>
<entry>freebsd-rc</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>problem with Xen emulation</entry>
<entry>kern</entry>
<entry>xen</entry>
<entry>alias</entry>
</row>
</tbody>
</table>
<table id=common-assignees-ports>
<title>Common Assignees &mdash; Ports Collection</title>
<tgroup cols="3">
<tgroup cols="4">
<thead>
<row>
<entry>Type</entry>
<entry>Suggested Category</entry>
<entry>Suggested Assignee</entry>
<entry>Assignee Type</entry>
</row>
</thead>
@ -531,42 +564,84 @@
(<emphasis>not</emphasis> with an individual port!)</entry>
<entry>ports</entry>
<entry>portmgr</entry>
<entry>alias</entry>
</row>
<row>
<entry>port which is maintained by apache@FreeBSD.org</entry>
<entry>ports</entry>
<entry>apache</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>port which is maintained by autotools@FreeBSD.org</entry>
<entry>ports</entry>
<entry>autotools</entry>
<entry>alias</entry>
</row>
<row>
<entry>port which is maintained by doceng@FreeBSD.org</entry>
<entry>ports</entry>
<entry>doceng</entry>
<entry>alias</entry>
</row>
<row>
<entry>port which is maintained by eclipse@FreeBSD.org</entry>
<entry>ports</entry>
<entry>freebsd-eclipse</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>port which is maintained by gecko@FreeBSD.org</entry>
<entry>ports</entry>
<entry>gecko</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>port which is maintained by gnome@FreeBSD.org</entry>
<entry>ports</entry>
<entry>gnome</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>port which is maintained by hamradio@FreeBSD.org</entry>
<entry>ports</entry>
<entry>hamradio</entry>
<entry>alias</entry>
</row>
<row>
<entry>port which is maintained by haskell@FreeBSD.org</entry>
<entry>ports</entry>
<entry>haskell</entry>
<entry>alias</entry>
</row>
<row>
<entry>port which is maintained by java@FreeBSD.org</entry>
<entry>ports</entry>
<entry>freebsd-java</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>port which is maintained by kde@FreeBSD.org</entry>
<entry>ports</entry>
<entry>kde</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>port which is maintained by mono@FreeBSD.org</entry>
<entry>ports</entry>
<entry>mono</entry>
<entry>mailing list</entry>
</row>
<row>
@ -574,24 +649,49 @@
openoffice@FreeBSD.org</entry>
<entry>ports</entry>
<entry>freebsd-openoffice</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>port which is maintained by perl@FreeBSD.org</entry>
<entry>ports</entry>
<entry>perl</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>port which is maintained by python@FreeBSD.org</entry>
<entry>ports</entry>
<entry>freebsd-python</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>port which is maintained by ruby@FreeBSD.org</entry>
<entry>ports</entry>
<entry>freebsd-ruby</entry>
<entry>mailing list</entry>
</row>
<row>
<entry>port which is maintained by secteam@FreeBSD.org</entry>
<entry>ports</entry>
<entry>secteam</entry>
<entry>alias</entry>
</row>
<row>
<entry>port which is maintained by vbox@FreeBSD.org</entry>
<entry>ports</entry>
<entry>vbox</entry>
<entry>alias</entry>
</row>
<row>
<entry>port which is maintained by x11@FreeBSD.org</entry>
<entry>ports</entry>
<entry>freebsd-x11</entry>
<entry>mailing list</entry>
</row>
</tbody>
</table>
@ -609,6 +709,35 @@
because everyone assumes that the assignee is already working
on it.</para>
<table id=common-assignees-other>
<title>Common Assignees &mdash; Other</title>
<tgroup cols="4">
<thead>
<row>
<entry>Type</entry>
<entry>Suggested Category</entry>
<entry>Suggested Assignee</entry>
<entry>Assignee Type</entry>
</row>
</thead>
<tbody>
<row>
<entry>problem with GNATS itself (&man.send-pr.1;)</entry>
<entry>bin</entry>
<entry>bugmeister</entry>
<entry>alias</entry>
</row>
<row>
<entry>problem with GNATS web form</entry>
<entry>www</entry>
<entry>bugmeister</entry>
<entry>alias</entry>
</row>
</tbody>
</table>
</section>
<section id="pr-assigned">
@ -620,7 +749,7 @@
work.</para>
<para>Assigned PRs should not be touched by anyone but the
assignee. If you have comments, submit a followup. If for
assignee or bugmeister. If you have comments, submit a followup. If for
some reason you think the PR should change state or be
reassigned, send a message to the assignee. If the assignee
does not respond within two weeks, unassign the PR and do as
@ -892,12 +1021,6 @@ This was misfiled because the subject did not have the format:
<para>Set Confidential to <literal>no</literal>.</para>
</listitem>
<listitem>
<para>Set Responsible to yourself (and not, e.g.,
<literal>freebsd-bugs</literal>, which merely
sends more mail).</para>
</listitem>
<listitem>
<para>Set State to <literal>closed</literal>.</para>
</listitem>