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

Tue Jul 2 23:28:16 UTC 2013

On Tue, 2 Jul 2013, Gabor Pali wrote:

> Author: pgj
> Date: Tue Jul  2 14:41:23 2013
> New Revision: 42117
> URL: http://svnweb.freebsd.org/changeset/doc/42117
>
>
> 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)
> @@ -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

s/behind with the used standards/using old versions of markup standards/, 
perhaps?  That's still not great, there may be a better wording.

> +	and DocBook 4.5.  However, we still depend on obsoleted

Probably s/obsoleted/obsolete/

> +	technologies — DSSSL and Jade.  Besides, DocBook 5.0
> +	provides a cleaner markup and some nice new features.</p>

Maybe s/a //?

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

missing comma (before 'since').  Some would quibble with the use of since 
instead of because, but I think that usage is well represented in the 
popular lexicon.

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

Two uses of "development" in the same sentence is disrecommended; maybe 
"updates to the rendering process are under development"?

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

I think "provides for" is slightly more correct.

-Ben

> +      <p>This project is generously founded by The &os; Foundation.</p>
> +    </body>