From owner-svn-doc-all@FreeBSD.ORG Sun Sep 22 17:24:52 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 72694B19; Sun, 22 Sep 2013 17:24:52 +0000 (UTC) (envelope-from eadler@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 3CE3B2C11; Sun, 22 Sep 2013 17:24:52 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r8MHOqaA056495; Sun, 22 Sep 2013 17:24:52 GMT (envelope-from eadler@svn.freebsd.org) Received: (from eadler@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r8MHOqvH056494; Sun, 22 Sep 2013 17:24:52 GMT (envelope-from eadler@svn.freebsd.org) Message-Id: <201309221724.r8MHOqvH056494@svn.freebsd.org> From: Eitan Adler Date: Sun, 22 Sep 2013 17:24:52 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42685 - head/en_US.ISO8859-1/articles/committers-guide X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 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: Sun, 22 Sep 2013 17:24:52 -0000 Author: eadler Date: Sun Sep 22 17:24:51 2013 New Revision: 42685 URL: http://svnweb.freebsd.org/changeset/doc/42685 Log: Add some instructions for committers that need to ask questions. Adapted from mail sent by bz@ to an internal list. Modified: head/en_US.ISO8859-1/articles/committers-guide/article.xml Modified: head/en_US.ISO8859-1/articles/committers-guide/article.xml ============================================================================== --- head/en_US.ISO8859-1/articles/committers-guide/article.xml Sun Sep 22 00:14:15 2013 (r42684) +++ head/en_US.ISO8859-1/articles/committers-guide/article.xml Sun Sep 22 17:24:51 2013 (r42685) @@ -2346,6 +2346,45 @@ ControlPersist yes will review code. + + If in doubt... + + When you are not sure about something, whether it be a + technical issue or a project convention be sure to ask. If you + stay silent you will never make progress. + + If it relates to a technical issue ask on the public + mailing lists. Avoid the temptation to email the individual + person that knows the answer. This way everyone will be able to + learn from the question and the answer. + + For project specific or administrative questions you should + ask, in order: + + + + Your mentor or former mentor. + + + + An experienced committer on IRC, email, etc. + + + + Any team with a "hat", as they should give you a + definitive answer. + + + + If still not sure, ask on &a.developers;. + + + + Once your question is answered, if no one pointed you to + documentation that spelled out the answer to your question, + document it, as others will have the same question. + + GNATS