[Openstack-docs] Can't build compute admin guide

Lorin Hochstein lorin at nimbisservices.com
Thu Apr 11 23:35:55 UTC 2013


Anne:

Is it possible to gate on building all of the manuals? I was under the
impression that this was already happening, but clearly it isn't.

Lorin


On Thu, Apr 11, 2013 at 7:33 PM, Anne Gentle <anne at openstack.org> wrote:

> It is fixed now.
>
> I think it went in 3 patches ago, I believe based on the Jenkins jobs. It
> was a missing title on the creating custom images section.
>
> Let's be sure to build locally before merging anything.
>
> Anne
>
> On Thursday, April 11, 2013, David Cramer wrote:
>
>> On 04/11/2013 03:55 PM, Lorin Hochstein wrote:
>> > I can't build the compute admin guide
>> > (https://bugs.launchpad.net/openstack-manuals/+bug/1168149). It might
>> > just be my setup, but I noticed that Joe's recent "boot from volume"
>> > changes (merged three days ago) aren't reflected on the website:
>> >
>> > https://review.openstack.org/25947
>> >
>> >
>> http://docs.openstack.org/trunk/openstack-compute/admin/content/boot-from-volume.html
>>
>> Hi Lorin,
>> I just did a pull and that doc builds off of master for me. In your
>> target directory you'll find a file named something like:
>>
>> bk-compute-adminguide.xml-invalid-2013-04-11T17:57:48.071-05:00.xml
>>
>> Please send me that file. Alternatively, you can open that file in
>> Oxygen and validate it. You'll see where the problem is and you can fix
>> it in the real source file.
>>
>> That file is the intermediate version of the doc that was validated.
>> There can be cases where due to profiling, the doc that was valid in the
>> editor is no longer valid 1/2 through processing.
>>
>> Btw., an improvement coming when I cut the next release of the plugin is
>> validation error messages will look like this:
>>
>> @@@@@@@@@@@@@@@@@@@@@@
>> !!!VALIDATION ERRORS!!
>> !!!!!!!!!!!!!!!!!!!!!!
>>
>> Note: Open the temporary file:
>>
>>
>> file:////home/dcramer/Documents/openstack/openstack-manuals-new/doc/src/docbkx/openstack-compute-admin/target/bk-compute-adminguide.xml-invalid-2013-04-11T17:57:48.071-05:00.xml
>>
>> to see all the errors in context.
>> You must correct the errors in the original
>> source DocBook or wadl files however.
>>
>> You can control whether build fails or not by
>> setting failOnValidationError to no in your pom.
>>
>> lineNumber:  20411; columnNumber: 10; element "para" not allowed yet;
>> expected element "info", "subtitle", "title" or "titleabbrev"
>>
>> !!!!!!!!!!!!!!!!!!!!!!
>> !!!VALIDATION ERRORS!!
>> @@@@@@@@@@@@@@@@@@@@@@
>>
>> Thanks,
>> David
>>
>>
>> _______________________________________________
>> 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/20130411/6d014da6/attachment-0001.html>


More information about the Openstack-docs mailing list