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
This commit is contained in:
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
|
@ -8,13 +8,18 @@
|
||||||
<html>
|
<html>
|
||||||
&header;
|
&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
|
issues associated with the FreeBSD Documentation Project. The main
|
||||||
responsibilities of this team are :</p>
|
responsibilities of this team are:</p>
|
||||||
|
|
||||||
<ul>
|
<ul>
|
||||||
<li>To grant approval for new doc/, www/, release documentation, and
|
<li>To grant approval for new documentation committers. Documentation
|
||||||
manual page committers.</li>
|
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
|
<li>To maintain the doc project primer, which documents best
|
||||||
practices for the FreeBSD Documentation Project.</li>
|
practices for the FreeBSD Documentation Project.</li>
|
||||||
|
@ -27,7 +32,7 @@
|
||||||
|
|
||||||
<li>To ensure that the generated documentation (PDF, HTML, etc.) on
|
<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
|
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
|
sure the Web site build is functioning correctly, and also
|
||||||
involves working with the admin team to ensure that the primary
|
involves working with the admin team to ensure that the primary
|
||||||
Web server has all of the requisite software installed
|
Web server has all of the requisite software installed
|
||||||
|
@ -46,7 +51,7 @@
|
||||||
the FreeBSD Web site and documentation.</li>
|
the FreeBSD Web site and documentation.</li>
|
||||||
</ul>
|
</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
|
resolution body for the FreeBSD Documentation Project. Discussion and
|
||||||
consensus on the freebsd-doc mailing list is how the project has
|
consensus on the freebsd-doc mailing list is how the project has
|
||||||
conducted itself, and how it is expected to conduct itself in the
|
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
|
The current members of this team are Glen Barber, Marc
|
||||||
Fonvieille, Gábor Kövesdán, and Hiroki Sato.
|
Fonvieille, Gábor Kövesdá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>
|
<h2>New Doc Committers</h2>
|
||||||
|
|
||||||
New doc committers are approved by doceng@ with a vote through email
|
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.
|
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>
|
<h2>Idle Doc Committers</h2>
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue