From owner-svn-doc-all@FreeBSD.ORG Mon Jun 4 14:56:06 2012 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id B57FB106566B; Mon, 4 Jun 2012 14:56:06 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id 9FA348FC1A; Mon, 4 Jun 2012 14:56:06 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id q54Eu62p048067; Mon, 4 Jun 2012 14:56:06 GMT (envelope-from gabor@svn.freebsd.org) Received: (from gabor@localhost) by svn.freebsd.org (8.14.4/8.14.4/Submit) id q54Eu6Y5048065; Mon, 4 Jun 2012 14:56:06 GMT (envelope-from gabor@svn.freebsd.org) Message-Id: <201206041456.q54Eu6Y5048065@svn.freebsd.org> From: Gabor Kovesdan Date: Mon, 4 Jun 2012 14:56:06 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r38980 - head/en_US.ISO8859-1/htdocs/internal X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 04 Jun 2012 14:56:06 -0000 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 @@ &header; -

The doceng@ team is a new body to handle some of the meta-project +

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 :

+ responsibilities of this team are:

    -
  • To grant approval for new doc/, www/, release documentation, and - manual page committers.
    • +
  • 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.
  • To maintain the doc project primer, which documents best practices for the FreeBSD Documentation Project.
    • @@ -27,7 +32,7 @@
  • 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.
-

It is specifically noted here that doceng@ is *not* a conflict +

It is specifically noted here that doceng@ is not 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.

The current members of this team are Glen Barber, Marc 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.

New Doc Committers

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.

Idle Doc Committers