[gentoo-doc] [RFC] GDP policy updates

[Sven Vermeulen]

Hi guys,

I'd like to suggest a few changes on our GDP policy, namely:

- updating the license comment if you use a different license should be
  mandatory (hence switch from "should" to "must")

  Reason: I think this is a "typo" as "must" fits more in the idea of that
  paragraph.

- drop using metadoc.xml for registering long outstanding bugs

  Reason: it was a nice idea, but never truely used

- have project lead (or delegated person) "decide" on the recruitment
  process / progress

  Reason: we already dropped the time frame windows in the past, but wasn't
  really clear who then decides that a phase can go through or not. So make
  it explicit that it is the lead (or a delegated person)

- drop mandatory gdp quiz, make it recommended

  Reason: we already have a contribution period where the recruit sends in
  contributions or patches; the knowledge on the GuideXML, as far as needed
  for the tasks the recruit wants to do, should be apparent from the
  contributions.

  The quiz requires more knowledge than we might expect from most
  documentation developers (not in the past, but given the resources at hand
  right now, it makes sense to remove the mandatory requirement).

Below is the suggested change on the policy.

Comments are of course welcome (otherwise I wouldn't mail to the mailinglist
:-P)

Wkr,
	Sven Vermeulen


Index: doc-policy.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/gdp/doc/doc-policy.xml,v
retrieving revision 1.27
diff -u -B -r1.27 doc-policy.xml
--- doc-policy.xml	29 Nov 2011 19:01:23 -0000	1.27
+++ doc-policy.xml	20 Mar 2013 17:04:40 -0000
@@ -186,7 +186,7 @@
 
 <p>
 If the 2.5 version is used, the tag can be either <c>&lt;license /&gt;</c> or
-<c>&lt;license version="2.5" /&gt;</c>. In either case should the comment be
+<c>&lt;license version="2.5" /&gt;</c>. In either case must the comment be
 updated to refer to the correct version URL.
 </p>
 
@@ -200,9 +200,7 @@
 Every bug reported on <uri link="http://bugs.gentoo.org">bugs.gentoo.org</uri>
 should be handled as fast as possible. If a bug cannot be handled
 in a timely fashion, the reporter of that bug should be informed about
-this using a comment on the bug, and the bug should be registered in the
-<uri link="/proj/en/gdp/doc/metadoc-guide.xml">metadoc.xml</uri> file, if
-applicable.
+this using a comment on the bug.
 </p>
 
 <p>
@@ -377,9 +375,10 @@
 
 <p>
 If you feel that you have shown sufficient amount of contributions, contact
-the project lead of the Gentoo Documentation Project. He will ask you for your
-coordinates and other information, and then arrange for the next phase to be
-started.
+the project lead of the Gentoo Documentation Project who will review the
+contributions and the timeframe (or delegate this towards another GDP member).
+He will ask you for your coordinates and other information, and
+then arrange for the next phase to be started.
 </p>
 
 </body>
@@ -403,22 +402,20 @@
 </p>
 
 <p>
-During this period, the recruit:
+During this period, the recruit: is advised to learn about Gentoo's inner workings.
+This is required as he or she will be asked later on to answer Gentoo's <uri
+link="/proj/en/devrel/quiz/staff-quiz.txt">Staffing Quiz</uri>.
 </p>
 
-<ul>
-  <li>
-    is advised to learn about Gentoo's inner workings.
-    This is required as he or she will be asked later on to answer Gentoo's <uri
-    link="/proj/en/devrel/quiz/staff-quiz.txt">Staffing Quiz</uri>.
-  </li>
-  <li>
-    will be asked to fill in the <uri
-    link="/proj/en/gdp/doc/doc-quiz.xml">Gentoo Documentation Project
-    Quiz</uri>. He or she needs to successfully pass this entire quiz
-    (all questions) before we can continue with the next Phase.
-  </li>
-</ul>
+<p>
+It is also recommended, but not automatically required, to fill in the <uri
+link="/proj/en/gdp/doc/doc-quiz.xml">Gentoo Documentation Project Quiz</uri>.
+This will assist the recruit in learning more about how the Gentoo Documentation
+Project documentation works. If at a later time the Gentoo Documentation Project
+lead feels that the recruit (or by then editor or author) shows insufficient
+knowledge on this, he might ask the recruit (or by then editor or author) to
+work on the quiz after all.
+</p>
 
 </body>
 </section>
@@ -441,9 +438,9 @@
 
 <p>
 If the recruit is already a Gentoo Developer, the same recruitment process is
-followed, but the staffing quiz is not necessary anymore. However, the <uri
+followed, but of course the staffing quiz is not necessary anymore. The <uri
 link="/proj/en/gdp/doc/doc-quiz.xml">Gentoo Documentation Project Quiz</uri> is
-still mandatory.
+still recommended.
 </p>
 
 </body>