[publican-list] Proposed changes to Book_Info.xml

[Michael Hideo-Smith]

----- "Jeff Fearn" <jfearn at redhat.com> wrote:

> From: "Jeff Fearn" <jfearn at redhat.com>
> To: "publican" <publican-list at redhat.com>
> Sent: Monday, August 18, 2008 3:37:10 PM GMT +10:00 Brisbane
> Subject: Re: [publican-list] Proposed changes to Book_Info.xml
>
> So after chatting with people about this here is the new, new plan!
> ;)
> 
> <bookinfo>
> 	<title>My Guide</title>
> 	<productname>The Product</productname>
> 	<productnumber>5.2</productnumber>
> 	<edition>1</edition>
> 	<pubsnumber>0</pubsnumber>
> 
> 
> 
> Where:
> 
> title: is the books title
> productname: is the products name
> productnumber: is the products version
> edition: is the edition (X.Y)
> pubsnumber: is the revision of this edition (Z)
> 
> 
> The Layout would roughly be:
> 
> Product Name Product Version*
> Title
> Subtitle*
> edition.pubsnumber
> 
> * = not mandatory
> 
> This gives us the ability to distinguish between major (X), minor (Y)
> and maintenance (Z) updates to documentation.
> 
> One of the main reasons for going to X.Y.Z is to allow translations to
> be updated independently of each other. So for any edition X.Y of a
> book, all translations have the same X.Y, but Z is independent for
> each and every language.
> 
> I'm currently working out with translators how best to allow them to
> set their own Z.
> 
> All comments and doughnuts gratefully received!
> 

+1