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

Update the doceng charter to reflect reality:

Browse source 
- 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
This commit is contained in:
Gabor Kovesdan 2012-06-04 14:56:06 +00:00
parent 4486adedbb
commit 1edcd0f681
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=38980
1 changed files with 15 additions and 10 deletions

25
en_US.ISO8859-1/htdocs/internal/doceng.sgml
View file

@ -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>