svn commit: r42884 - head/en_US.ISO8859-1/htdocs/news/status

Mon Oct 7 22:35:08 UTC 2013

Author: pgj
Date: Mon Oct  7 22:35:07 2013
New Revision: 42884
URL: http://svnweb.freebsd.org/changeset/doc/42884

Log:
  - Add Q3 report on the FDP edits
  
  Submitted by:	wblock

Modified:
  head/en_US.ISO8859-1/htdocs/news/status/report-2013-07-2013-09.xml

Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-07-2013-09.xml
==============================================================================

--- head/en_US.ISO8859-1/htdocs/news/status/report-2013-07-2013-09.xml	Mon Oct  7 22:14:13 2013	(r42883)
+++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-07-2013-09.xml	Mon Oct  7 22:35:07 2013	(r42884)
@@ -19,7 +19,7 @@
 
     <!-- XXX: keep updating the number of entries -->
     <p>Thanks to all the reporters for the excellent work!  This report
-      contains 24 entries and we hope you enjoy reading it.</p>
+      contains 25 entries and we hope you enjoy reading it.</p>
 
     <!-- XXX: set date for the next set of submissions -->
     <p>The deadline for submissions covering between October and
@@ -1279,4 +1279,42 @@
       <task>Import MATE into the ports tree.</task>
     </help>
   </project>
+
+  <project cat='doc'>
+    <title>&os; Documentation Project Primer Edit</title>
+
+    <contact>
+      <person>
+	<name>
+	  <given>Warren</given>
+	  <common>Block</common>
+	</name>
+	<email>wblock at FreeBSD.org</email>
+      </person>
+    </contact>
+
+    <links>
+      <url href="http://www.freebsd.org/doc/en/books/fdp-primer/book.html"/>
+    </links>
+
+    <body>
+      <p>The &os; Documentation Project Primer had not changed at the
+	same rate as the documents themselves.  Some sections were
+	outdated, others were wordy and confusing, while information on
+	new changes to the documentation were not described at all.  In
+	July, Warren gave the entire FDP Primer a fairly intense edit
+	for simplicity and clarity.  Chapters and sections were moved
+	into a more logical order, and information was updated to be a
+	better guide to the current state.  Markup examples were added
+	and revised.  Style guidelines were also extended and updated.
+	The Primer is now far more consistent and usable.  As always,
+	there is still room for improvement, and additions or
+	corrections are encouraged.</p>
+    </body>
+
+    <help>
+      <task>An introductory chapter on writing manual pages with
+	<tt>mdoc(7)</tt> would be an excellent addition.</task>
+    </help>
+  </project>
 </report>
