/[gentoo]/xml/htdocs/proj/en/gdp/doc/doc-policy.xml
Gentoo

Diff of /xml/htdocs/proj/en/gdp/doc/doc-policy.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.13 Revision 1.14
1<?xml version='1.0' encoding="UTF-8"?> 1<?xml version='1.0' encoding="UTF-8"?>
2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/gdp/doc/doc-policy.xml,v 1.13 2005/06/02 16:44:16 swift Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/gdp/doc/doc-policy.xml,v 1.14 2005/06/02 16:48:26 swift Exp $ -->
3 3
4<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 4<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
5 5
6<guide link="doc-policy.xml"> 6<guide link="doc-policy.xml">
7 7
25Contributers should know and exercise. 25Contributers should know and exercise.
26</abstract> 26</abstract>
27 27
28<license/> 28<license/>
29 29
30<version>3.11</version> 30<version>3.12</version>
31<date>2005-05-07</date> 31<date>2005-06-02</date>
32 32
33<chapter> 33<chapter>
34<title>Introduction</title> 34<title>Introduction</title>
35<section> 35<section>
36<title>Introduction</title> 36<title>Introduction</title>
76represents an active development team of a Gentoo Documentation 76represents an active development team of a Gentoo Documentation
77Subproject. 77Subproject.
78</p> 78</p>
79 79
80<p> 80<p>
81The Gentoo Documentation Project is strategically led by a top-level manager 81The Gentoo Documentation Project is strategically led by a top-level Manager
82as required by the <uri link="/doc/en/management-structure.xml">Gentoo 82as required by the <uri link="/doc/en/management-structure.xml">Gentoo
83Management Structure</uri>. This document also describes the responsibilities 83Management Structure</uri>. This document also describes the responsibilities
84of the strategic manager with respect to Gentoo Linux. 84of the Strategic Manager with respect to Gentoo Linux.
85</p> 85</p>
86 86
87<p> 87<p>
88For day-to-day managerial tasks, the Gentoo Documentation Project has an 88For day-to-day managerial tasks, the Gentoo Documentation Project has an
89operational manager. This person keeps track of all documentation-related tasks 89Operational Manager. This person keeps track of all documentation-related tasks
90that are more short-term. The operational manager and strategic manager can be 90that are more short-term. The Operational Manager and Strategic Manager can be
91one and the same if the strategic manager wishes so. 91one and the same if the Strategic Manager wishes so.
92</p> 92</p>
93 93
94<p> 94<p>
95Currently these positions are taken by the following people: 95Currently these positions are taken by the following people:
96</p> 96</p>
112 <ti><mail link="neysx@gentoo.org">neysx</mail></ti> 112 <ti><mail link="neysx@gentoo.org">neysx</mail></ti>
113</tr> 113</tr>
114</table> 114</table>
115 115
116<p> 116<p>
117Every subproject has a strategic manager of its own and may have an 117Every subproject has a Strategic Manager of its own and may have an
118Operational Manager if deemed appropriate. His responsibilities to the Gentoo 118Operational Manager if deemed appropriate. His responsibilities to the Gentoo
119Documentation Project are the same as are listed on the <uri 119Documentation Project are the same as are listed on the <uri
120link="/doc/en/management-structure.xml#doc_chap1_sect5">Gentoo Management 120link="/doc/en/management-structure.xml#doc_chap1_sect5">Gentoo Management
121Structure</uri>. 121Structure</uri>.
122</p> 122</p>
123 123
124<p> 124<p>
125The subprojects of the Gentoo Documentation Team together with their respective 125The subprojects of the Gentoo Documentation Team together with their respective
126strategic managers are listed on the <uri link="/proj/en/gdp/">GDP 126Strategic Managers are listed on the <uri link="/proj/en/gdp/">GDP
127Website</uri>. 127Website</uri>.
128</p> 128</p>
129 129
130<p> 130<p>
131The decision on adding subprojects is in hands of the strategic manager. 131The decision on adding subprojects is in hands of the strategic Manager.
132</p> 132</p>
133 133
134</body> 134</body>
135</section> 135</section>
136<section> 136<section>
172<title>Documentation Translation Teams</title> 172<title>Documentation Translation Teams</title>
173<body> 173<body>
174 174
175<p> 175<p>
176Every language should be backed up by an official translation team. This 176Every language should be backed up by an official translation team. This
177team is lead by a lead translator and perhaps a follow-up lead translator, who 177team is lead by a Lead Translator and perhaps a Follow-up Lead Translator, who
178both have CVS commit access. If for any reason the lead translator cannot 178both have CVS commit access. If for any reason the Lead Translator cannot
179perform his or her duties, the follow-up lead translator is in charge. If 179perform his or her duties, the Follow-up Lead Translator is in charge. If
180even this person is unavailable, the mentor(s) is/are in charge of the language. 180even this person is unavailable, the mentor(s) is/are in charge of the language.
181</p> 181</p>
182 182
183<p> 183<p>
184If a translated document is contributed, but the language in itself is 184If a translated document is contributed, but the language in itself is
187translation team of that language is formed. 187translation team of that language is formed.
188</p> 188</p>
189 189
190<p> 190<p>
191When a language is officially supported, but the team doesn't have any 191When a language is officially supported, but the team doesn't have any
192members or no one wants to take on the responsibilities of the lead 192members or no one wants to take on the responsibilities of the Lead
193translator, all links to the documents will be removed from the site. 193Translator, all links to the documents will be removed from the site.
194However, the documents will stay available in case the language becomes 194However, the documents will stay available in case the language becomes
195officially supported again. 195officially supported again.
196</p> 196</p>
197 197
198</body> 198</body>
238Every bug reported on <uri link="http://bugs.gentoo.org">bugs.gentoo.org</uri> 238Every bug reported on <uri link="http://bugs.gentoo.org">bugs.gentoo.org</uri>
239should be handled as fast as possible. If a bug cannot be handled 239should be handled as fast as possible. If a bug cannot be handled
240in a timely fashion, the reporter of that bug should be informed about 240in a timely fashion, the reporter of that bug should be informed about
241this using a comment on the bug and the bug should be registered in the 241this using a comment on the bug and the bug should be registered in the
242<uri link="/proj/en/gdp/doc/metadoc-guide.xml">metadoc.xml</uri> file, if 242<uri link="/proj/en/gdp/doc/metadoc-guide.xml">metadoc.xml</uri> file, if
243applicable. The tactical or operational manager may decide that a bug has a 243applicable. The Tactical or Operational Manager may decide that a bug has a
244higher priority and should be addressed ahead any other task the assingee 244higher priority and should be addressed ahead any other task the assingee
245is responsible of. 245is responsible of.
246</p> 246</p>
247 247
248<p> 248<p>
249Whenever a Gentoo Documentation Team member takes care of a bug, he or 249Whenever a Gentoo Documentation Team member takes care of a bug, he or
250she should assign the bug to herself/himself, but make sure that 250she should assign the bug to herself/himself, but make sure that
251<c>docs-team@gentoo.org</c> is on the Cc-list. Unless with the consent 251<c>docs-team@gentoo.org</c> is on the Cc-list. Unless with the consent
252of the operational manager, a bug may not be taken away from another 252of the Operational Manager, a bug may not be taken away from another
253Gentoo Documentation Team member without their approval. 253Gentoo Documentation Team member without their approval.
254</p> 254</p>
255 255
256</body> 256</body>
257</section> 257</section>
327both changes must be committed separately so that translators can easily 327both changes must be committed separately so that translators can easily
328view the important changes (content) and ignore the coding changes. 328view the important changes (content) and ignore the coding changes.
329</p> 329</p>
330 330
331<p> 331<p>
332In case of a translation, the lead translator of the language is 332In case of a translation, the Lead Translator of the language is
333responsible for the document. Only he may commit the document to CVS 333responsible for the document. Only he may commit the document to CVS
334unless he is currently "in training", in which case his or her 334unless he is currently "in training", in which case his or her
335mentor should commit it. 335mentor should commit it.
336</p> 336</p>
337 337
355 deliberately go against the decisions made policy-wise or through a 355 deliberately go against the decisions made policy-wise or through a
356 consensus-model on the Gentoo Documentation mailinglist 356 consensus-model on the Gentoo Documentation mailinglist
357 </li> 357 </li>
358 <li> 358 <li>
359 not performing at all for a long time without informing the GDP and without 359 not performing at all for a long time without informing the GDP and without
360 replying to the operational manager's request for a status update 360 replying to the Operational Manager's request for a status update
361 </li> 361 </li>
362</ul> 362</ul>
363 363
364<p> 364<p>
365will be reported to the <uri link="/proj/en/devrel/">Gentoo Developer 365will be reported to the <uri link="/proj/en/devrel/">Gentoo Developer

Legend:
Removed from v.1.13  
changed lines
  Added in v.1.14

  ViewVC Help
Powered by ViewVC 1.1.20