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

Tue Jul 2 14:41:24 UTC 2013

Author: pgj
Date: Tue Jul  2 14:41:23 2013
New Revision: 42117
URL: http://svnweb.freebsd.org/changeset/doc/42117

Log:
  - Add entry on DocBook 5 transition
  
  Submitted by:	gabor

Modified:
  head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml

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

--- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml	Tue Jul  2 13:55:18 2013	(r42116)
+++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml	Tue Jul  2 14:41:23 2013	(r42117)
@@ -18,7 +18,7 @@
 
     <!-- XXX: keep updating the number of entries -->
     <p>Thanks to all the reporters for the excellent work!  This report
-      contains 8 entries and we hope you enjoy reading it.</p>
+      contains 9 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 July and September 2013
@@ -61,6 +61,12 @@
     <description>Ports</description>
   </category>
 
+  <category>
+    <name>docs</name>
+
+    <description>Documentation</description>
+  </category>
+
   <project cat='proj'>
     <title>PC-BSD</title>
 
@@ -404,4 +410,53 @@
       <task>Remove the dependency on HAL.</task>
     </help>
   </project>
+
+  <project cat='docs'>
+    <title>Upgrading the Documentation Set to DocBook 5.0</title>
+
+    <contact>
+      <person>
+	<name>
+	  <given>Gábor</given>
+	  <common>Kövesdán</common>
+	</name>
+	<email>gabor at FreeBSD.org</email>
+      </person>
+    </contact>
+
+    <body>
+      <p>The Documentation Project has been behind with the used
+	standards until recently when we switched to a real XML toolchain
+	and DocBook 4.5.  However, we still depend on obsoleted
+	technologies — DSSSL and Jade.  Besides, DocBook 5.0
+	provides a cleaner markup and some nice new features.</p>
+
+      <p>The objective of this project is to upgrade the documentation
+	set to DocBook 5.0 and to find a way to properly render our
+	sources without using DSSSL since the DSSSL stylesheets are
+	discontinued and cannot render DocBook 5.0.  The documentation
+	sources have already been successfully transformed to DocBook
+	5.0 and the development of the rendering process is under
+	development.  The common opinion among &os; developers is that
+	Java is a heavy dependency that should be avoided.  This has
+	suggested the transformation of DocBook sources to TeX and use
+	TeX as a rendering backend.  There are two ways to do this; the
+	sources can be transformed either directly or through the XSL FO
+	output generated by the stylesheets that the DocBook Project
+	provides.  The latter approach has been chosen as a preferred
+	way since it better fits the existing documentation
+	infrastructure and provides easier customization.</p>
+
+      <p>This project is generously founded by The &os; Foundation.</p>
+    </body>
+
+    <help>
+      <task>Finish the implementation of the rendering process.</task>
+
+      <task>Integrate the rendering solution into the
+	infrastructure.</task>
+
+      <task>Merge back changes to <tt>head</tt>.</task>
+    </help>
+  </project>
 </report>
