Open Stack

Yep, Steve's got it. Thanks!

Bug logged at https://bugs.launchpad.net/openstack-manuals/+bug/1171513 and
I've assigned Diane Fleming, she's familiar with the DocBook schema.

After we close that bug, we can start gating on validation. Woo!

Anne


On Mon, Apr 22, 2013 at 10:29 AM, Steve Gordon <sgordon at redhat.com> wrote:

> ----- 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
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20130422/e644fc2c/attachment.html>