From owner-svn-doc-head@FreeBSD.ORG Mon Oct 7 22:35:08 2013 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id B5783B12; Mon, 7 Oct 2013 22:35:08 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 890EA2A86; Mon, 7 Oct 2013 22:35:08 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r97MZ839017856; Mon, 7 Oct 2013 22:35:08 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r97MZ8mJ017855; Mon, 7 Oct 2013 22:35:08 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201310072235.r97MZ8mJ017855@svn.freebsd.org> From: Gabor Pali Date: Mon, 7 Oct 2013 22:35:08 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42884 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 07 Oct 2013 22:35:08 -0000 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 @@

Thanks to all the reporters for the excellent work! This report - contains 24 entries and we hope you enjoy reading it.

+ contains 25 entries and we hope you enjoy reading it.

The deadline for submissions covering between October and @@ -1279,4 +1279,42 @@ Import MATE into the ports tree. + + + &os; Documentation Project Primer Edit + + + + + Warren + Block + + wblock@FreeBSD.org + + + + + + + + +

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.

+ + + + An introductory chapter on writing manual pages with + mdoc(7) would be an excellent addition. + +