Open Stack

I noticed the lack of a friendly error message too today working on another doc. I'll look into it. I also need to look into profiling cover text.

David

David
----
typed wthi thubms.

-----Original Message-----
From: Anne Gentle [anne at openstack.org]
Received: Monday, 20 Aug 2012, 10:30pm
To: Lorin Hochstein [lorin at nimbisservices.com]
CC: openstack-docs [openstack-docs at lists.openstack.org]
Subject: Re: [Openstack-docs] Compute admin guid broken?

Typically I open the bk file in Oxygen and look for red bars on the side, which indicates non validating files are included. In this case I worked backward from what had been merged in the compute admin bk file and opened that chapter file and clicked on all the red marks until I found the missing XML:ids.

Back in 1.2.n or so, you got a nice error in the build when IDs were missing. Maybe David Cramer can investigate further?

Anne



On Aug 20, 2012, at 10:05 PM, Lorin Hochstein <lorin at nimbisservices.com<mailto:lorin at nimbisservices.com>> wrote:

Anne:

How did you ever debug this?

Also, is it possible to configure the maven tasks to generate a more meaningful error message when the ids are missing from sections? That's a tough one to spot.

Take care,

Lorin
--
Lorin Hochstein
Lead Architect - Cloud Services
Nimbis Services, Inc.
www.nimbisservices.com<https://www.nimbisservices.com/>



On Aug 20, 2012, at 10:34 PM, Anne Gentle <anne at openstack.org<mailto:anne at openstack.org>> wrote:

Ok, I've submitted two patchsets that should fix the problem with
missing xml:id on all sections (the new MooseFS sections were missing
some IDs.)

essex (merged) https://review.openstack.org/#/c/11689/
master: https://review.openstack.org/#/c/11690/

As always, be sure the guide builds for you locally when doing a
review. I know it's tough to know which errors are real, though. So I
do want to make sure you all know that we are working on getting rid
of the mostly meaningless "Failed to load image:" errors by updating
the tool to check for figures correctly.  That could be in the next
release of the clouddocs-maven plugin. We are at 1.4.0 now, possibly
the image improvements could be in a new release as soon as 3 weeks
from now.

Thanks,
Anne

On Mon, Aug 20, 2012 at 9:03 PM, Anne Gentle <anne at openstack.org<mailto:anne at openstack.org>> wrote:
Jenkins reports all is well and built four times today:

[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 2:50.759s
[INFO] Finished at: Mon Aug 20 16:34:54 UTC 2012
[INFO] Final Memory: 51M/406M
[INFO] ------------------------------------------------------------------------
channel stopped
FTP: Connecting from host [oneiric5.slave.openstack.org<http://oneiric5.slave.openstack.org>]
FTP: Connecting with configuration [docs.openstack.org<http://docs.openstack.org>] ...
FTP: Disconnecting configuration [docs.openstack.org<http://docs.openstack.org>] ...
FTP: Transferred 440 file(s)


I'll investigate further based on the info in the bugs. Thanks for reporting!

Anne

On Mon, Aug 20, 2012 at 9:00 PM, Lorin Hochstein
<lorin at nimbisservices.com<mailto:lorin at nimbisservices.com>> wrote:
Is anybody able to build the compute admin guide on their local machines?
Tom hit a problem in master
<https://bugs.launchpad.net/openstack-manuals/+bug/1038546>, and I think
there are additional problems, because I can't build stable/essex either
<https://bugs.launchpad.net/openstack-manuals/+bug/1039305>.

Is Jenkins able to build the latest commits?

Take care,

Lorin
--
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<mailto:Openstack-docs at lists.openstack.org>
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20120821/e4cb5866/attachment.html>