[Openstack-docs] Help with build

David Cramer david.cramer at rackspace.com
Wed Aug 28 19:08:54 UTC 2013


Btw., we might test with CR1 of the 5.1 schema:

http://docbook.org/xml/5.1CR1/rng/

Specifically:
http://docbook.org/xml/5.1CR1/rng/docbookxi.rng

That should fix the problem. If it doesn't, then we will want to log a bug.

Regards,
David

On 08/27/2013 12:04 AM, Andreas Jaeger wrote:
> On 08/26/2013 11:13 PM, Anne Gentle wrote:
>> [...] 
>> Our gate runs tools/validate.py, true, and we need validation to happen
>> at the gate, yes. I'm saying I want us all to agree to the .rng schema
>> not just put in a terribly forgiving one. 
>>
>> I want a bigger view and more time to think through what we really want.
>> I'm currently not in agreement with David Cramer about what should be
>> xi:included -- it's really hard to maintain XML that points to
>> fine-grained inclusions if you're not the only author or you don't sit
>> next to each other and so on. So I am wanting a wider window for
>> considerations for our global contributor base. 
>>
>> I also want everyone to know that this particular patch has file names
>> with colons and parens and slashes in them, and won't validate any way,
>> even if the section is added, until those file names are changed. Since
>> the files are auto-generated, we'll need to change the file name
>> generation portion as well. I've patched the patch to try to get Tom
>> unblocked but he'll have to pick up where he left off and change those
>> file names as well.
>>
>> Thanks,
>> Anne
> 
> Thanks Anne for the detailed explanation, this is a good approach forward,
> 
> Andreas
> 




More information about the Openstack-docs mailing list