svn commit: r38980 - head/en_US.ISO8859-1/htdocs/internal

Mon Jun 4 14:56:06 UTC 2012

Author: gabor
Date: Mon Jun  4 14:56:06 2012
New Revision: 38980
URL: http://svn.freebsd.org/changeset/doc/38980

Log:
  Update the doceng charter to reflect reality:
  - doceng@ is not new at all
  - clarify two types of doc commit bits
  - doc is now in SVN
  - remove stating translators will be added to doceng@ since this text has
    been there for a long time but it never has been a criterion when
    inviting members
  - voting deadline is 2 weeks (however, it is a worst case) for doceng
    since there are only four members and we need representative numbers
    for a vote
  - style fixes
  
  With hat:	doceng

Modified:
  head/en_US.ISO8859-1/htdocs/internal/doceng.sgml

Modified: head/en_US.ISO8859-1/htdocs/internal/doceng.sgml
==============================================================================

--- head/en_US.ISO8859-1/htdocs/internal/doceng.sgml	Mon Jun  4 14:49:17 2012	(r38979)
+++ head/en_US.ISO8859-1/htdocs/internal/doceng.sgml	Mon Jun  4 14:56:06 2012	(r38980)
@@ -8,13 +8,18 @@
 <html>
   &header;
 
-<p>The doceng@ team is a new body to handle some of the meta-project
+<p>The doceng@ team is a body to handle some of the meta-project
   issues associated with the FreeBSD Documentation Project.  The main
-  responsibilities of this team are :</p>
+  responsibilities of this team are:</p>
 
 <ul>
-  <li>To grant approval for new doc/, www/, release documentation, and
-      manual page committers.</li>
+  <li>To grant approval for new documentation committers.  Documentation
+    includes articles and books, website pages, manual pages, release
+    notes and translations of the above.  There are two kinds of
+    doc commit bits: translator commit bit, which is limited to
+    translations in a particular language and full commit bit, which
+    is only granted to aspirants, who have shown enough English
+    writing skills.</li>
 
   <li>To maintain the doc project primer, which documents best
       practices for the FreeBSD Documentation Project.</li>
@@ -27,7 +32,7 @@
 
   <li>To ensure that the generated documentation (PDF, HTML, etc.) on
       the Web site and FTP site are up to date with respect to the
-      versions of the documents in the CVS tree.  This includes making
+      versions of the documents in the SVN tree.  This includes making
       sure the Web site build is functioning correctly, and also
       involves working with the admin team to ensure that the primary
       Web server has all of the requisite software installed
@@ -46,7 +51,7 @@
       the FreeBSD Web site and documentation.</li>
 </ul>
 
-<p>It is specifically noted here that doceng@ is *not* a conflict
+<p>It is specifically noted here that doceng@ is <strong>not</strong> a conflict
 resolution body for the FreeBSD Documentation Project.  Discussion and
 consensus on the freebsd-doc mailing list is how the project has
 conducted itself, and how it is expected to conduct itself in the
@@ -56,16 +61,16 @@ future.</p>
 
 The current members of this team are Glen Barber, Marc
 Fonvieille, G&aacute;bor K&ouml;vesd&aacute;n, and Hiroki Sato.
-It is expected that the membership of this list will increase
-as additional members from the various translation teams are added.
 
 <h2>New Doc Committers</h2>
 
 New doc committers are approved by doceng@ with a vote through email
-and a 1 week timeout.  A committer is approved if at least 1 doceng@
+and a two week timeout.  A committer is approved if at least one doceng@
 member votes yes, and no doceng@ members vote no.
 
-core@ is CCed on the message to accounts@ about the new account.
+When a commit bit proposal is accepted, doceng@ sends out an
+acceptance email to the mentor and the new committer with core@
+and accounts@ CC'ed.
 
 <h2>Idle Doc Committers</h2>
 
