- Add Q3 report on the FDP edits

Submitted by:	wblock
This commit is contained in:
Gabor Pali 2013-10-07 22:35:07 +00:00
parent 43afaf66d9
commit 75bc3c1c42
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=42884

View file

@ -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@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>