<div dir="ltr">Anne:<div><br></div><div>Once we have the customized schema file, it will be fairly trivial to update the script to point to it (one line change in validate.py): </div><div><br></div><div><a href="https://github.com/openstack/openstack-manuals/blob/master/tools/validate.py#L63">https://github.com/openstack/openstack-manuals/blob/master/tools/validate.py#L63</a><br>
</div><div><br></div><div>Lorin</div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Mon, Aug 26, 2013 at 10:54 AM, Anne Gentle <span dir="ltr"><<a href="mailto:anne@openstack.org" target="_blank">anne@openstack.org</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote"><div><div class="h5">On Mon, Aug 26, 2013 at 9:50 AM, Lorin Hochstein <span dir="ltr"><<a href="mailto:lorin@nimbisservices.com" target="_blank">lorin@nimbisservices.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><br><div class="gmail_extra"><div class="gmail_quote"><div><div>On Mon, Aug 26, 2013 at 10:43 AM, Anne Gentle <span dir="ltr"><<a href="mailto:anne@openstack.org" target="_blank">anne@openstack.org</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">
<div><div>On Mon, Aug 26, 2013 at 9:29 AM, Lorin Hochstein <span dir="ltr"><<a href="mailto:lorin@nimbisservices.com" target="_blank">lorin@nimbisservices.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr"><br><div class="gmail_extra"><div class="gmail_quote">
<div>On Mon, Aug 26, 2013 at 9:37 AM, Anne Gentle <span dir="ltr"><<a href="mailto:anne@openstack.org" target="_blank">anne@openstack.org</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">
<div>On Mon, Aug 26, 2013 at 6:21 AM, Andreas Jaeger <span dir="ltr"><<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div>On 08/26/2013 04:32 AM, Tom Fifield wrote:<br>
> Hi,<br>
><br>
> I've tried to fix this one <a href="https://review.openstack.org/#/c/43032" target="_blank">https://review.openstack.org/#/c/43032</a><br>
><br>
> for build for a bit, but it's hard without a line number for the<br>
> validation error. I've isolated it to the file<br>
> section_object-storage-features.xml.<br>
><br>
> Any ideas?<br>
<br>
<br>
</div>I found the culprit:<br>
Remove from line 748 this include:<br>
<br>
<xi:include<br>
href="../common/tables/swift-proxy-server-(filter:slo).xml"/><br>
<br>
I guess you need to wrap that in a section but can't debug further now,<br>
<br></blockquote><div><br></div></div><div>Yep, the para table elements need to be wrapped in a section. </div><div><br></div><div>I'm hesitant to stop validating individual files because many people need to use a non-validating editor. Can we find a way to validate individual files against a schema that we all agree to? </div>
</div></div></div></blockquote><div><br></div></div><div>Anne:</div><div><br></div><div>Is the individual file validation useful for people using a non-validating editor? Given that validate.py now runs maven on all changed books and will fail if a book doesn't build, is there any value added by running validation against individual files? </div>
<div><br></div><div>The only advantage I could imagine is if the individual file validation gave clearer error messages than maven, but I'm not even sure if that's the case. </div></div></div></div></blockquote><div>
<br></div></div></div><div>I'm thinking of the scenario where Tom got an error message from Maven but still couldn't find the error. When I use a validating editor it's easy to find. When I'm not, it's not. So my sense of the overall need is for more fine-grained indicators to locate and troubleshoot.</div>
<div>
<div> </div></div></div></div></div></blockquote><div><br></div></div></div><div>Ah, gotcha.</div><div><br></div><div>In that case, David, can you generate that customized schema you made reference to earlier (less constrained in what's allowed in the root node)? We can add it to the repository and use that for individual file checking.</div>
<span><font color="#888888">
<div><br></div></font></span></div></div></div></blockquote><div><br></div></div></div><div>Do any Pythonistas know if it's possible to customize the lxml library to insert your own customized schema? That's a potential shortcut I think.</div>
<div class="im">
<div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><span><font color="#888888"><div>
</div><div>Lorin</div></font></span></div><div><div><br></div>-- <br><div dir="ltr">Lorin Hochstein<br><div>Lead Architect - Cloud Services</div><div>Nimbis Services, Inc.</div><div><a href="http://www.nimbisservices.com" target="_blank">www.nimbisservices.com</a></div>
</div>
</div></div></div>
</blockquote></div></div><br></div></div>
</blockquote></div><br><br clear="all"><div><br></div>-- <br><div dir="ltr">Lorin Hochstein<br><div>Lead Architect - Cloud Services</div><div>Nimbis Services, Inc.</div><div><a href="http://www.nimbisservices.com" target="_blank">www.nimbisservices.com</a></div>
</div>
</div>