source: trunk/doc/guide/xml/project/policies.xml @ 5311

Last change on this file since 5311 was 5311, checked in by wbb4, 16 years ago

Bug:
Submitted by:
Reviewed by:
Approved by:
Obtained from:

Committer also has two m's.

  • Property svn:eol-style set to native
File size: 7.5 KB
Line 
1<?xml version="1.0" encoding="UTF-8" ?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3                "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="policies">
5  <chapterinfo>
6    <keywordset>
7      <keyword>
8      </keyword>
9    </keywordset>
10  </chapterinfo>
11 
12  <title>DarwinPorts Policies</title> 
13
14  <sect1>
15    <title>About this Chapter</title>
16
17                <para>This chapter contains policies and procedures, as well as
18                responsbilities for the DarwinPorts Project.</para>
19  </sect1>
20
21  <sect1>
22          <title>Port Maintenance Protocol</title>
23          <para>
24                  DarwinPorts does not enforce exclusive write access to the maintainer
25                  of a given Port, however it is normal practice to inform the maintainer
26                  before making any changes to a Port. Detailed procedures are described
27                  below.   
28          </para>
29          <sect2>
30                  <title>Updating Ports You Do Not Maintain</title>
31                  <para>
32                          If you have identified a port for which you have a
33                          suggestion, because it is broken, insecure, out of date or
34                          could be enhanced in some way you should:
35                  </para>
36                  <orderedlist numeration='arabic'>
37                          <listitem>
38                                  Write patch for the port that resolves the issue,
39                                  and email maintainer or file a bug in Bugzilla. If
40                                  you can't write a patch, file a bug and ignore the
41                                  following steps...
42                          </listitem>
43                          <listitem>
44                                  Wait for response from maintainer. You should receive
45                                  a response within 72hrs. Once you are in a dialog with
46                                  a maintainer, the maintainer should review and apply
47                                  patches.
48                          </listitem>
49                          <listitem>
50                                  If a response is not received within 72hrs another
51                                  committer should  review the patches and update the port
52                                  (this may be the person originally submitting the patches).
53                                  If the person suggesting the changes does not have
54                                  write-access to the repository, they should send an
55                                  email to darwinports@opendarwin.org with a summary of the
56                                  bug and a reference to a bugzilla bug.
57                          </listitem>
58
59                  </orderedlist>
60                  <para>
61                          There are several situations in which this procedure can be waived:
62                  </para>
63
64                  <orderedlist>
65                          <listitem>
66                                  A mass update to darwinports which touches many ports
67                                  (usually because of a change in the darwinports
68                                  infrastructure)
69                          </listitem>
70                          <listitem>
71                                  The port is broken in a way that requires urgent action.
72                                  This may be because the port breaks system functionality
73                                  or the current version has a serious security problem.
74                          </listitem>
75                          <listitem>
76                                  The port maintainer is not defined or is assigned to
77                                  darwinports@opendarwin.org. Feel free to take over
78                                  such ports!
79                          </listitem>
80                          <listitem>
81                                  The port is abandoned by it's current maintainer.
82                                  i.e. Any Port with a 'Port Abandoned' bug (explained below)
83                                  can be updated without contacting the maintainer.
84                          </listitem>
85                  </orderedlist>
86          </sect2>
87          <sect2>
88                  <title>Port Abandonment</title>
89                  <para>
90                          Abandonment is defined as when a bug has not been acknowledged
91                          for more than 3 weeks after the bug was filed. If this occurs
92                          a new bug should be filed in bugzilla against the port with
93                          the subject: [Port Abandoned] and that port should reference
94                          the ignored bug.
95                  </para>
96                  <para>
97                          The Port Abandoned bug should be resolved when a new maintainer
98                          is assigned.
99                  </para>
100          </sect2>
101  </sect1>
102
103
104  <sect1>
105    <title>Committer's Category Responsibility List</title>
106
107                <para>DarwinPorts has at least one committer responsible for each
108                category of ports (<filename>www</filename>,
109                <filename>textproc</filename>, etc).  This is a list of those
110                committers.</para>
111
112                <table frame="all">
113                        <title>Committer's Category Responsibility List</title>
114                        <tgroup cols="3" align="left" colsep="1" rowsep="1">
115                                <colspec colname="category"/>
116                                <colspec colname="committera"/>
117                                <colspac colname="committerb"/>
118                                <thead>
119                                        <row>
120                                                <entry>Category</entry>
121                                                <entry>Committer A</entry>
122                                                <entry>Committer B</entry>
123                                        </row>
124                                </thead>
125                                <tbody>
126                                        <row>
127                                                <entry>aqua</entry>
128                                                <entry/>
129                                                <entry/>
130                                        </row>
131                                        <row>
132                                                <entry>archives</entry>
133                                                <entry>waqar [at] opendarwin.org</entry>
134                                                <entry></entry>
135                                        </row>
136                                        <row>
137                                                <entry>audio</entry>
138                                                <entry>macdome [at] opendarwin.org</entry>
139                                                <entry/>
140                                        </row>
141                                        <row>
142                                                <entry>benchmarks</entry>
143                                                <entry>toby [at] opendarwin.org</entry>
144                                                <entry/>
145                                        </row>
146                                        <row>
147                                                <entry>comms</entry>
148                                                <entry>fenner [at] opendarwin.org</entry>
149                                                <entry/>
150                                        </row>
151                                        <row>
152                                                <entry>databases</entry>
153                                                <entry>cms [at] opendarwin.org</entry>
154                                                <entry>macdome [at] opendarwin.org</entry>
155                                        </row>
156                                        <row>
157                                                <entry>devel</entry>
158                                                <entry>fkr [at] opendarwin.org</entry>
159                                                <entry/>
160                                        </row>
161                                        <row>
162                                                <entry>editors</entry>
163                                                <entry>waqar [at] opendarwin.org</entry>
164                                                <entry>olegb [at] opendarwin.org</entry>
165                                        </row>
166                                        <row>
167                                                <entry>emulators</entry>
168                                                <entry>fkr [at] opendarwin.org</entry>
169                                                <entry/>
170                                        </row>
171                                        <row>
172                                                <entry>games</entry>
173                                                <entry>toby [at] opendarwin.org</entry>
174                                                <entry/>
175                                        </row>
176                                        <row>
177                                                <entry>genealogy</entry>
178                                                <entry/>
179                                                <entry/>
180                                        </row>
181                                        <row>
182                                                <entry>gnome</entry>
183                                                <entry>olegb [at] opendarwin.org</entry>
184                                                <entry>fkr [at] opendarwin.org</entry>
185                                        </row>
186                                        <row>
187                                                <entry>graphics</entry>
188                                                <entry>jkh [at] opendarwin.org</entry>
189                                                <entry>fkr [at] opendarwin.org</entry>
190                                        </row>
191                                        <row>
192                                                <entry>irc</entry>
193                                                <entry>fkr [at] opendarwin.org</entry>
194                                                <entry/>
195                                        </row>
196                                        <row>
197                                                <entry>lang</entry>
198                                                <entry>gwright [at] opendarwin.org</entry>
199                                                <entry/>
200                                        </row>
201                                        <row>
202                                                <entry>mail</entry>
203                                                <entry>cms [at] opendarwin.org</entry>
204                                                <entry/>
205                                        </row>
206                                        <row>
207                                                <entry>math</entry>
208                                                <entry>gwright [at] opendarwin.org</entry>
209                                                <entry>macdome [at] opendarwin.org</entry>
210                                        </row>
211                                        <row>
212                                                <entry>multimedia</entry>
213                                                <entry/>
214                                                <entry/>
215                                        </row>
216                                        <row>
217                                                <entry>net</entry>
218                                                <entry>fenner [at] opendarwin.org</entry>
219                                                <entry>fkr [at] opendarwin.org</entry>
220                                        </row>
221                                        <row>
222                                                <entry>news</entry>
223                                                <entry/>
224                                                <entry/>
225                                        </row>
226                                        <row>
227                                                <entry>print</entry>
228                                                <entry>cms [at] opendarwin.org</entry>
229                                                <entry/>
230                                        </row>
231                                        <row>
232                                                <entry>python</entry>
233                                                <entry>mww [at ] opendarwin.org</entry>
234                                                <entry>rshaw [at] opendarwin.org</entry>
235                                        </row>
236                                        <row>
237                                                <entry>ruby</entry>
238                                                <entry>rshaw [at] opendarwin.org</entry>
239                                                <entry></entry>
240                                        </row>
241                                        <row>
242                                                <entry>science</entry>
243                                                <entry>wbb4 [at] opendarwin.org</entry>
244                                                <entry/>
245                                        </row>
246                                        <row>
247                                                <entry>shells</entry>
248                                                <entry>waqar [at] opendarwin.org</entry>
249                                                <entry/>
250                                        </row>
251                                        <row>
252                                                <entry>sysutils</entry>
253                                                <entry>ssen [at] opendarwin.org</entry>
254                                                <entry/>
255                                        </row>
256                                        <row>
257                                                <entry>textproc</entry>
258                                                <entry>wbb4 [at] opendarwin.org</entry>
259                                                <entry/>
260                                        </row>
261                                        <row>
262                                                <entry>www</entry>
263                                                <entry>cms [at] opendarwin.org</entry>
264                                                <entry>wbb4 [at] opendarwin.org</entry>
265                                        </row>
266                                        <row>
267                                                <entry>x11</entry>
268                                                <entry>jkh [at] opendarwin.org</entry>
269                                                <entry>olegb [at] opendarwin.org</entry>
270                                        </row>
271                                </tbody>
272                        </tgroup>
273                </table>
274
275  </sect1>
276</chapter>
Note: See TracBrowser for help on using the repository browser.