Open Stack

----- Original Message -----
> From: "Lorin Hochstein" <lorin at nimbisservices.com>
> To: "Anne Gentle" <anne at openstack.org>
> Cc: openstack-docs at lists.openstack.org
> Sent: Sunday, April 21, 2013 2:28:14 PM
> Subject: Re: [Openstack-docs] Can't build compute admin guide
> 
> Hi Anne:
> 
> Jenkins is running tools/validate.py, but it's configured to not gate, so
> the output looks like this in Gerrit:
> 
> 
> Jenkins4:31 AM
> 
> Patch Set 3: Works for me
> 
> Build succeeded.
> 
>    -
>    http://docs-draft.openstack.org/gate-openstack-cli-guide/check/1038/cli/quick-start
> :
>    SUCCESS
>    -
>    http://logs.openstack.org/26954/3/check/gate-openstack-operations-guide/351
> :
>    SUCCESS
>    -
>    http://logs.openstack.org/26954/3/check/gate-openstack-manuals-validate/587
> :
>    FAILURE (non-voting)
> 
> (The third one, gate-openstack-manuals-validate, is what's running the
> script).
> 
> 
> Right now it looks like there's something it doesn't like in
> doc/src/docbkx/openstack-ops/src/app_usecases.xml:
> 
> 2013-04-21 08:29:18.913 |
> /home/jenkins/workspace/gate-openstack-manuals-validate/doc/src/docbkx/openstack-ops/src/app_usecases.xml:13:0:ERROR:RELAXNGV:RELAXNG_ERR_ELEMNAME:
> Expecting element section, got part
> 2013-04-21 08:29:18.914 |
> /home/jenkins/workspace/gate-openstack-manuals-validate/doc/src/docbkx/openstack-ops/src/app_usecases.xml:13:0:ERROR:RELAXNGV:RELAXNG_ERR_ELEMWRONG:
> Did not expect element part there
> 
> 
> I'm not sure why this script is complaining but the doc toolchain is
> parsing it properly, I guess the validate script is stricter somehow.
> 
> 
> Lorin

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:

app_usecases.xml:15: element para: Relax-NG validity error : Did not expect element para there
app_usecases.xml:15: element para: Relax-NG validity error : Element part failed to validate content
app_usecases.xml fails to validate

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>).

Thanks,

Steve

Steve