diff --git a/en_US.ISO8859-1/books/fdp-primer/overview/chapter.xml b/en_US.ISO8859-1/books/fdp-primer/overview/chapter.xml index 6646cf9659..7359231707 100644 --- a/en_US.ISO8859-1/books/fdp-primer/overview/chapter.xml +++ b/en_US.ISO8859-1/books/fdp-primer/overview/chapter.xml @@ -137,22 +137,14 @@ Quick Start 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 XML and the suggestions in - . 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. + documentation. First, subscribe to the &a.doc;. + Some team members also interact on the + #bsddocs + IRC channel on + EFnet. These people + can help with questions or problems involving the documentation. - - Subscribe to the &a.doc;. Some mailing list members - also interact on the #bsddocs - IRC channel on EFnet. - - Install the textproc/docproj @@ -162,11 +154,10 @@ Install a local working copy of the documentation - from a mirror of the &os; repository (see - ) in - ~/doc. + from a mirror of the &os; repository in + ~/doc (see ). - &prompt.user; svn checkout https://svn0.us-west.FreeBSD.org/doc/head /usr/doc + &prompt.user; svn checkout https://svn0.us-west.FreeBSD.org/doc/head ~/doc @@ -194,12 +185,12 @@ Update the local working copy: - &prompt.user; svn up ~/doc + &prompt.user; svn up ~/doc 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. References to tag and entity usage can be found in @@ -214,9 +205,7 @@ 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;. + problems. Repeat until all of the errors are resolved. @@ -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 - HTML, type make in the + HTML, run make in the en_US.ISO8859-1/books/handbook/ directory.