Date: Sun, 22 Sep 2013 17:24:52 +0000 (UTC) From: Eitan Adler <eadler@FreeBSD.org> 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 Message-ID: <201309221724.r8MHOqvH056494@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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</screen> will review code.</para> </sect1> + <sect1 id="if-in-doubt"> + <title>If in doubt...</title> + + <para>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.</para> + + <para>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.</para> + + <para>For project specific or administrative questions you should + ask, in order: </para> + + <itemizedlist> + <listitem> + <para>Your mentor or former mentor.</para> + </listitem> + + <listitem> + <para>An experienced committer on IRC, email, etc.</para> + </listitem> + + <listitem> + <para>Any team with a "hat", as they should give you a + definitive answer.</para> + </listitem> + + <listitem> + <para>If still not sure, ask on &a.developers;.</para> + </listitem> + </itemizedlist> + + <para>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.</para> + </sect1> + <sect1 id="gnats"> <title>GNATS</title>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201309221724.r8MHOqvH056494>