Date: Sun, 20 May 2012 20:55:21 +0000 (UTC) From: Glen Barber <gjb@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r38858 - head/en_US.ISO8859-1/articles/committers-guide Message-ID: <201205202055.q4KKtL4r015651@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: gjb Date: Sun May 20 20:55:21 2012 New Revision: 38858 URL: http://svn.freebsd.org/changeset/doc/38858 Log: - Update the Conventions and Traditions to reflect the doc CVS->SVN conversion. - Add a note that the .ent, .sgml, and .xml files are in the doc repository. Modified: head/en_US.ISO8859-1/articles/committers-guide/article.sgml Modified: head/en_US.ISO8859-1/articles/committers-guide/article.sgml ============================================================================== --- head/en_US.ISO8859-1/articles/committers-guide/article.sgml Sun May 20 20:32:48 2012 (r38857) +++ head/en_US.ISO8859-1/articles/committers-guide/article.sgml Sun May 20 20:55:21 2012 (r38858) @@ -2696,18 +2696,25 @@ $target - head/$source:$P,$Q,$R</screen> <sect2 id="conventions-committers"> <title>Guidelines For Committers</title> + <note> + <para>The <literal>.ent</literal>, <literal>.sgml</literal>, + and <literal>.xml</literal> files listed below exist in the + &os; Documentation Project SVN repository at + <hostid role="fqdn">svn.FreeBSD.org/doc/</hostid>.</para> + </note> + <para>If you have been given commit rights to one or more of the repositories:</para> <itemizedlist> <listitem> <para>Add your author entity to - <filename>doc/en_US.ISO8859-1/share/sgml/authors.ent</filename>; + <filename>head/en_US.ISO8859-1/share/sgml/authors.ent</filename>; this should be done first since an omission of this commit will cause the next commits to break the doc/ build.</para> <para>This is a relatively easy task, but remains a good first test of - your CVS skills.</para> + your version control skills.</para> <note> <para>Don't forget to get mentor approval for these patches!</para> @@ -2717,36 +2724,36 @@ $target - head/$source:$P,$Q,$R</screen> <listitem> <para>Also add your author entity to - <filename>www/en/developers.sgml</filename>.</para> + <filename>head/share/sgml/developers.ent</filename>.</para> </listitem> <listitem> <para>Add yourself to the <quote>Developers</quote> section of the <ulink url="&url.articles.contributors;/index.html">Contributors List</ulink> - (<filename>doc/en_US.ISO8859-1/articles/contributors/contrib.committers.sgml</filename>) and remove yourself from the <quote>Additional - Contributors</quote> section (<filename>doc/en_US.ISO8859-1/articles/contributors/contrib.additional.sgml</filename>). + (<filename>head/en_US.ISO8859-1/articles/contributors/contrib.committers.sgml</filename>) and remove yourself from the <quote>Additional + Contributors</quote> section (<filename>head/en_US.ISO8859-1/articles/contributors/contrib.additional.sgml</filename>). Please note that entries are sorted by last name.</para> </listitem> <listitem> <para>Add an entry for yourself to - <filename>www/share/sgml/news.xml</filename>. Look for the other + <filename>head/share/sgml/news.xml</filename>. Look for the other entries that look like <quote>A new committer</quote> and follow the format.</para> </listitem> <listitem> <para>You should add your PGP or GnuPG key to - <filename>doc/share/pgpkeys</filename> (and if you do not + <filename>head/share/pgpkeys</filename> (and if you do not have a key, you should create one). Do not forget to commit - the updated <filename>doc/share/pgpkeys/pgpkeys.ent</filename> - and <filename>doc/share/pgpkeys/pgpkeys-developers.sgml</filename>. + the updated <filename>head/share/pgpkeys/pgpkeys.ent</filename> + and <filename>head/share/pgpkeys/pgpkeys-developers.sgml</filename>. Please note that entries are sorted by last name.</para> <para>&a.des; has - written a shell script (<filename>doc/share/pgpkeys/addkey.sh</filename>) to make this extremely simple. See the + written a shell script (<filename>head/share/pgpkeys/addkey.sh</filename>) to make this extremely simple. See the <ulink - url="http://cvsweb.FreeBSD.org/doc/share/pgpkeys/README">README</ulink>; + url="http://svnweb.FreeBSD.org/doc/head/share/pgpkeys/README">README</ulink>; file for more information.</para> <note>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201205202055.q4KKtL4r015651>