<div dir="ltr">Yep, Steve's got it. Thanks!<div><br></div><div>Bug logged at <a href="https://bugs.launchpad.net/openstack-manuals/+bug/1171513">https://bugs.launchpad.net/openstack-manuals/+bug/1171513</a> and I've assigned Diane Fleming, she's familiar with the DocBook schema.</div>

<div><br></div><div style>After we close that bug, we can start gating on validation. Woo!</div><div style><br></div><div style>Anne</div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Mon, Apr 22, 2013 at 10:29 AM, Steve Gordon <span dir="ltr"><<a href="mailto:sgordon@redhat.com" target="_blank">sgordon@redhat.com</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im">----- Original Message -----<br>
> From: "Lorin Hochstein" <<a href="mailto:lorin@nimbisservices.com">lorin@nimbisservices.com</a>><br>
> To: "Anne Gentle" <<a href="mailto:anne@openstack.org">anne@openstack.org</a>><br>
> Cc: <a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a><br>
> Sent: Sunday, April 21, 2013 2:28:14 PM<br>
> Subject: Re: [Openstack-docs] Can't build compute admin guide<br>
><br>
> Hi Anne:<br>
><br>
> Jenkins is running tools/validate.py, but it's configured to not gate, so<br>
> the output looks like this in Gerrit:<br>
><br>
><br>
</div>> Jenkins4:31 AM<br>
<div class="im">><br>
> Patch Set 3: Works for me<br>
><br>
> Build succeeded.<br>
><br>
</div>>    -<br>
>    <a href="http://docs-draft.openstack.org/gate-openstack-cli-guide/check/1038/cli/quick-start" target="_blank">http://docs-draft.openstack.org/gate-openstack-cli-guide/check/1038/cli/quick-start</a><br>
> :<br>
>    SUCCESS<br>
>    -<br>
>    <a href="http://logs.openstack.org/26954/3/check/gate-openstack-operations-guide/351" target="_blank">http://logs.openstack.org/26954/3/check/gate-openstack-operations-guide/351</a><br>
> :<br>
>    SUCCESS<br>
<div class="im">>    -<br>
>    <a href="http://logs.openstack.org/26954/3/check/gate-openstack-manuals-validate/587" target="_blank">http://logs.openstack.org/26954/3/check/gate-openstack-manuals-validate/587</a><br>
> :<br>
>    FAILURE (non-voting)<br>
><br>
> (The third one, gate-openstack-manuals-validate, is what's running the<br>
> script).<br>
><br>
><br>
> Right now it looks like there's something it doesn't like in<br>
> doc/src/docbkx/openstack-ops/src/app_usecases.xml:<br>
><br>
> 2013-04-21 08:29:18.913 |<br>
> /home/jenkins/workspace/gate-openstack-manuals-validate/doc/src/docbkx/openstack-ops/src/app_usecases.xml:13:0:ERROR:RELAXNGV:RELAXNG_ERR_ELEMNAME:<br>
> Expecting element section, got part<br>
> 2013-04-21 08:29:18.914 |<br>
> /home/jenkins/workspace/gate-openstack-manuals-validate/doc/src/docbkx/openstack-ops/src/app_usecases.xml:13:0:ERROR:RELAXNGV:RELAXNG_ERR_ELEMWRONG:<br>
> Did not expect element part there<br>
><br>
><br>
> I'm not sure why this script is complaining but the doc toolchain is<br>
> parsing it properly, I guess the validate script is stricter somehow.<br>
><br>
><br>
> Lorin<br>
<br>
</div>If you look at the bk_ops_guide.xml file you will find it includes part_usecases.xml, *not* app_usecases.xml. As such I suspect the build tooling never looks at the app_usecases.xml file because it's not explicitly included anywhere while the validation checks run on all XML files in the repository. The content of the two files is largely identical but the root node differs (part_usecases.xml uses <appendix> while app_usecases.xml uses <part>...). Additionally when I validate the files locally using xmllint part_usecases.xml passes validation but app_usecases.xml fails with:<br>


<br>
app_usecases.xml:15: element para: Relax-NG validity error : Did not expect element para there<br>
app_usecases.xml:15: element para: Relax-NG validity error : Element part failed to validate content<br>
app_usecases.xml fails to validate<br>
<br>
I believe this is because unlike an <appendix> a <part> element can not include a <para> element directly (normally it would be nested in a <partintro>).<br>
<br>
Thanks,<br>
<br>
Steve<br>
<span class="HOEnZb"><font color="#888888"><br>
Steve<br>
</font></span></blockquote></div><br></div>