[publican-list] Publican 3.0 -- with DocBook 5 or without?

[Jared Morgan]

You would have my support Rudi.

I was frustrated when I discovered I couldn't have gentext on <task> elements because enabling this change would require changes to DocBook 4.5. And changes to DocBook 4.5 were no longer possible. 

The PressGang styles (Maven jDocBook Blue and Grey base styles) for the JBoss Community already offer a namespaced version (for DocBook 5), and a non-namespaced version for DocBook 4.5 projects. Drools is already building to the new DocBook 5 DTD. So looking at cross compatibility with Publican and Maven, moving to DocBook 5 would be a positive move from my viewpoint.

And, yes, I would most definitely raise bugs if I found any output issues.

Cheers

Jared
----- Original Message -----
From: "Ruediger Landmann" <r.landmann at redhat.com>
To: "Publican discussions" <publican-list at redhat.com>
Sent: Tuesday, June 28, 2011 2:47:25 PM
Subject: [publican-list] Publican 3.0 -- with DocBook 5 or without?

Hey all;

It's been six months since our last release and the bugfixes have been 
piling up, along with a few major enhancements. We'd like to ship 
Publican 3.0 sometime soon.

However, we also face a major design decision. Publican was designed to 
support DocBook 4; now that DocBook 5 is out, do we want to move 
Publican to use that instead?

Since we'll need new, separate stylesheets for DocBook 5, supporting 
both versions of the schema would require more maintenance than we're 
able to provide. It really has to be one or the other.

The single biggest reason to move to DocBook 5 is that DocBook 4 is now 
feature-frozen and in maintenance mode; the DocBook project's energies 
are going into DocBook 5.[1]

Against that, the new style sheets will create the potential for 
breakage. Documents will need careful checking to make sure that they 
render properly. This will require effort from everyone in the community.

We need to know that Publican userbase is going to help find the 
inevitable problems and file bugs when they do.

Opinions please, people?

Cheers
Rudi



[1] 
http://www.docbook.org/tdg5/en/html/ch01.html#introduction-why-to-switch

_______________________________________________
publican-list mailing list
publican-list at redhat.com
https://www.redhat.com/mailman/listinfo/publican-list
Wiki: https://fedorahosted.org/publican