diff options
author | Glen Barber <gjb@FreeBSD.org> | 2012-05-20 20:55:21 +0000 |
---|---|---|
committer | Glen Barber <gjb@FreeBSD.org> | 2012-05-20 20:55:21 +0000 |
commit | 84c284fbefe1d76df1234be3fa9180ce5c31c2c9 (patch) | |
tree | 50b3d0d11c8f04c2be4305bee16044d9ddcf2551 /en_US.ISO8859-1 | |
parent | 669674039b95eb783c5825241bb3fc920abf579e (diff) | |
download | doc-84c284fbefe1d76df1234be3fa9180ce5c31c2c9.tar.gz doc-84c284fbefe1d76df1234be3fa9180ce5c31c2c9.zip |
- 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.
Notes
Notes:
svn path=/head/; revision=38858
Diffstat (limited to 'en_US.ISO8859-1')
-rw-r--r-- | en_US.ISO8859-1/articles/committers-guide/article.sgml | 29 |
1 files changed, 18 insertions, 11 deletions
diff --git a/en_US.ISO8859-1/articles/committers-guide/article.sgml b/en_US.ISO8859-1/articles/committers-guide/article.sgml index a25040aefd..e8dca1edef 100644 --- a/en_US.ISO8859-1/articles/committers-guide/article.sgml +++ b/en_US.ISO8859-1/articles/committers-guide/article.sgml @@ -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> |