Open Stack

----- Original Message -----
> From: "Anne Gentle" <anne at openstack.org>
> To: "Steve Gordon" <sgordon at redhat.com>
> Cc: openstack-docs at lists.openstack.org, "David Cramer" <david.cramer at rackspace.com>
> Sent: Saturday, April 20, 2013 2:43:00 PM
> Subject: Re: [Openstack-docs] Basic Install - please review
> 
> Oh wow that's interesting. I'm guessing your toolchain is publican since
> you're @redhat.com -- what's your root node, <article>?

Guilty as charged, it is indeed publican :). It expects <set>, <article>, or <book> as the root node - the other guides in the openstack-manuals project consistently use <book> so things have lined up as far as that goes - this one just caught me by surprise.

There are a few other areas where I've run into issues with the rigid processing expectations publican applies but for the most part I have been able to work around these by writing some rudimentary XSL transforms (and filing bugs against publican to get these processing expectations loosened up a bit in future). I'm hoping to tidy these up and publish the transforms to github in the next week or so.

Obviously reading between the lines what I am attempting to do is ensure that we can single source from the openstack-manuals project and concentrate more of our future documentation efforts on contributing to it.

Thanks,

Steve