Date: Mon, 22 Jul 2013 21:23:03 +0000 (UTC) From: Warren Block <wblock@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42385 - head/en_US.ISO8859-1/books/fdp-primer/overview Message-ID: <201307222123.r6MLN3gf025284@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: wblock Date: Mon Jul 22 21:23:03 2013 New Revision: 42385 URL: http://svnweb.freebsd.org/changeset/doc/42385 Log: Shorten the quick start a little more by factoring out repeated references to the mailing list, make some corrections in wording and directories. Modified: head/en_US.ISO8859-1/books/fdp-primer/overview/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/overview/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/overview/chapter.xml Mon Jul 22 21:08:56 2013 (r42384) +++ head/en_US.ISO8859-1/books/fdp-primer/overview/chapter.xml Mon Jul 22 21:23:03 2013 (r42385) @@ -137,23 +137,15 @@ <title>Quick Start</title> <para>Some preparatory steps must be taken before editing the &os; - documentation. New contributors will interact with other - members of the &os; Documentation Team, which can assist in - learning to use <acronym>XML</acronym> and the suggestions in - <xref linkend="writing-style-guide"/>. If a new user - contributes regularly, a Documentation Team member may be - assigned as a mentor to guide the user through the process from - contributor to documentation committer.</para> + documentation. First, subscribe to the &a.doc;. + Some team members also interact on the + <literal>#bsddocs</literal> + <acronym>IRC</acronym> channel on + <ulink url="http://www.efnet.org/">EFnet</ulink>. These people + can help with questions or problems involving the documentation.</para> <procedure> <step> - <para>Subscribe to the &a.doc;. Some mailing list members - also interact on the <literal>#bsddocs</literal> - <acronym>IRC</acronym> channel on <ulink - url="http://www.efnet.org/">EFnet</ulink>.</para> - </step> - - <step> <para>Install the <filename role="package">textproc/docproj</filename> package or port. This meta-port installs all of the @@ -162,11 +154,10 @@ <step> <para>Install a local working copy of the documentation - from a mirror of the &os; repository (see - <xref linkend="working-copy"/>) in - <filename class="directory">~/doc</filename>.</para> + from a mirror of the &os; repository in + <filename class="directory">~/doc</filename> (see <xref linkend="working-copy"/>).</para> - <screen>&prompt.user; <userinput>svn checkout https://<replaceable>svn0.us-west.FreeBSD.org</replaceable>/doc/head <replaceable>/usr/doc</replaceable></userinput></screen> + <screen>&prompt.user; <userinput>svn checkout https://<replaceable>svn0.us-west.FreeBSD.org</replaceable>/doc/head <replaceable>~/doc</replaceable></userinput></screen> </step> <step> @@ -194,12 +185,12 @@ <step> <para>Update the local working copy:</para> - <screen>&prompt.user; <userinput>svn up ~/doc</userinput></screen> + <screen>&prompt.user; <userinput>svn up <replaceable>~/doc</replaceable></userinput></screen> </step> <step> <para>Edit the documentation files that require changes. If a - file needs major changes, consult the &a.doc; for + file needs major changes, consult the mailing list for input.</para> <para>References to tag and entity usage can be found in @@ -214,9 +205,7 @@ <para>Review the output and edit the file to fix any problems shown, then rerun the command to find any remaining - problems. Repeat until all of the errors that are fixable - are resolved. If an error seems unsolvable, ask for - assistance on the &a.doc;.</para> + problems. Repeat until all of the errors are resolved.</para> </step> <step> @@ -225,7 +214,7 @@ top-level directory of the documentation being edited will generate that documentation in split HTML format. For example, to build the English version of the Handbook in - <acronym>HTML</acronym>, type <command>make</command> in the + <acronym>HTML</acronym>, run <command>make</command> in the <filename>en_US.ISO8859-1/books/handbook/</filename> directory.</para> </step>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201307222123.r6MLN3gf025284>