Re: [docbook-tc] Version reference for DocBook Publishers documents?

[Nic Gibson <nicg@corbas.net>]

On 3 Feb 2011, at 10:37, Dave Pawson wrote:

> On 3 February 2011 09:53, Nic Gibson <nicg@corbas.net> wrote:
> 
>> I think there possibly needs to be a different set of decisions here. Right now, we have the TDG guidelines. Those make perfect sense for something that originates outside of the DocBook infrastructure as it were. What appears to be needed is a way to identify an official variant on DocBook in a way that makes it clear that it isn't DocBook but is an official and public variant.
> 
> That is exactly what is covered by tdg :-)
> http://www.docbook.org/tdg51/en/html/ch05.html#s-notdocbook
> 
> 

I take your point :)
By those guidelines we should be using a new version 'number' that looks something like:

"5.0-extension publishers-1.0"

(or possibly "5.0-variant publishers-1.0")

I think that slightly misses the point that I'm trying to make though - DocBook Publishers has an official 'DocBook-ness'  in an way that (say) the DocBook 4.3 variants I've created for a set of biochemistry texts didn't have - those were done for a specific publisher and had a public identifier that indicated that. 

Given that there are now two special purpose DocBook sub-committees, I'd like to see something that indicates that closer relationship with DocBook. Perhaps that's just wishful thinking on my part, though.

> 
>  There are three possible ways to identify this as far as I can see
>> 
>> 1) A new root element
>> 2) A namespace for the new elements (what about the modified elements?)
>> 3) A new version
>> 
>> I think that 3) is the least destructive.
>> 
>>> Is website a fair comparison?
>> 
>> I think it probably is. How is website 'identified'?
> 
> I doubt this was raised when Norm (IIRC) developed website
> (and slides?) for his own use, then publicised them.
> 
> website has a different document element, as does slides,
> just that they use a customization layer on top of docbook.
> 
> Which may point to a similar route for db-pubs as being
> a previously trodden one?

> Customization for the schema/stylseheets, relying
> on the base infrastructure of docbook for support.
> 
> Shouting "This is not docbook" is possibly 4 on your list Nic,
> as per tdg, but it doesn't get us very far in terms of usage
> and clarity when using docbook tools.

That's why I didn't add it - I don't see that it gets us anywhere useful.

> 
> With this logic, I could be swayed towards 1) above?

I'm not convinced that it gets us anywhere useful but I think that the precedent of website and slides is worth considering.

cheers

nic


> 
> regards
> 
> 
> -- 
> Dave Pawson
> XSLT XSL-FO FAQ.
> Docbook FAQ.
> http://www.dpawson.co.uk
> 
> ---------------------------------------------------------------------
> To unsubscribe from this mail list, you must leave the OASIS TC that
> generates this mail.  Follow this link to all your TCs in OASIS at:
> https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
> 

--
Nic Gibson
Corbas Consulting
Digital Publishing Consultancy and Training
http://www.corbas.co.uk, +44 (0)7718 906817