Open Stack

David:

Yes, the validation script are only looking at individual files right now,
which is why they don't catch missing cross-references.

I agree that maven would be better for gating. But maven isn't currently
gating, is it?


Lorin


On Thu, Jul 18, 2013 at 3:55 PM, David Cramer <david.cramer at rackspace.com>wrote:

> I think the problem here is actually with the gating validation script.
> It must only be validating individual files instead of the book files.
>
> I think in this case the gating job is redundant. The maven plugin will
> also already validate xrefs and links by validating the root document.
>
> There was a time (pre 1.6.0 IIRC) when the maven plugin was not checking
> xrefs and links (IDREFs), but it does now so perhaps the gate job is no
> longer needed?
>
> David
>
> On 07/18/2013 02:49 PM, Lorin Hochstein wrote:
> > Unfortunately, the validation gating script isn't able to check
> > cross-references yet. :(
> >
> > https://bugs.launchpad.net/openstack-manuals/+bug/1031374
> >
> >
> > Lorin
> >
> >
> >
> > On Thu, Jul 18, 2013 at 3:38 PM, Anne Gentle
> > <annegentle at justwriteclick.com <mailto:annegentle at justwriteclick.com>>
> > wrote:
> >
> >     Oh, looks like the most recent patch for schedulers went in and
> >     broke the compute admin manual's build...
> >     compute-scheduler-config-ref" without matching ID.
> >
> >     Does anyone have some bandwidth today to fix it?
> >     Thanks,
> >     Anne
> >
> >
> >     On Thu, Jul 18, 2013 at 2:01 PM, Anne Gentle
> >     <annegentle at justwriteclick.com
> >     <mailto:annegentle at justwriteclick.com>> wrote:
> >
> >         Generally speaking, your document will need to validate in order
> >         to publish. So I don't think you can
> >         set  'failOnValidationError=no' and get your document through
> >         the gate.
> >
> >         What's the link (or is it an xi:include) that's failing?
> >
> >         Anne
> >
> >
> >         On Thu, Jul 18, 2013 at 1:45 PM, Denis Bradford
> >         <denisbatgm at gmail.com <mailto:denisbatgm at gmail.com>> wrote:
> >
> >             Looking for guidance on testing my changes to a specific
> >             manual before
> >             committing:
> >
> >             The openstack-compute-admin fails to validate because it
> >             contains a
> >             link to the openstack-config manual. When I try to build
> >             anyway, maven
> >             output suggests setting 'failOnValidationError=no'. Okay to
> >             suppress
> >             validation errors like that?
> >
> >             _______________________________________________
> >             Openstack-docs mailing list
> >             Openstack-docs at lists.openstack.org
> >             <mailto:Openstack-docs at lists.openstack.org>
> >
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
> >
> >
> >
> >
> >         --
> >         Anne Gentle
> >         annegentle at justwriteclick.com
> >         <mailto:annegentle at justwriteclick.com>
> >
> >
> >
> >
> >     --
> >     Anne Gentle
> >     annegentle at justwriteclick.com <mailto:annegentle at justwriteclick.com>
> >
> >     _______________________________________________
> >     Openstack-docs mailing list
> >     Openstack-docs at lists.openstack.org
> >     <mailto:Openstack-docs at lists.openstack.org>
> >     http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
> >
> >
> >
> >
> > --
> > Lorin Hochstein
> > Lead Architect - Cloud Services
> > Nimbis Services, Inc.
> > www.nimbisservices.com <http://www.nimbisservices.com>
> >
> >
> > _______________________________________________
> > Openstack-docs mailing list
> > Openstack-docs at lists.openstack.org
> > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
> >
>
>


-- 
Lorin Hochstein
Lead Architect - Cloud Services
Nimbis Services, Inc.
www.nimbisservices.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20130718/597891f8/attachment.html>