<div dir="ltr">Sean:<div><br></div><div>I'm the original author of the validate.py script, but unfortunately I can't provide much insight into why the script is failing.</div><div><br></div><div>The validation script checks the bk001-ch003-associate-general.xml file against a RelaxNG DocBook schema. It's basically equivalent to doing the following on the command-line:</div>
<div><br></div><div>xmllint --relaxng  <a href="http://www.oasis-open.org/docbook/xml/5.0b5/rng/docbookxi.rng">http://www.oasis-open.org/docbook/xml/5.0b5/rng/docbookxi.rng</a> --noout doc/src/docbkx/openstack-training/bk001-ch003-associate-general.xml<br>
</div><div><br></div><div>Which gives similar errors:</div><div><div><br></div><div>doc/src/docbkx/openstack-training/bk001-ch003-associate-general.xml:5: element chapter: Relax-NG validity error : Expecting element set, got chapter</div>
<div>doc/src/docbkx/openstack-training/bk001-ch003-associate-general.xml:5: element chapter: Relax-NG validity error : Did not expect element chapter there</div><div>doc/src/docbkx/openstack-training/bk001-ch003-associate-general.xml:9: element para: Relax-NG validity error : Did not expect element para there</div>
<div>doc/src/docbkx/openstack-training/bk001-ch003-associate-general.xml:13: element include: Relax-NG validity error : Element chapter has extra content: include</div><div>doc/src/docbkx/openstack-training/bk001-ch003-associate-general.xml:5: element chapter: Relax-NG validity error : Expecting element section, got chapter</div>
<div>doc/src/docbkx/openstack-training/bk001-ch003-associate-general.xml fails to validate</div></div><div><br></div><div>I'm fine with adding openstack-training to FILE_EXCEPTIONS and removing from BOOK_EXCEPTIONS, but I don't think we really need individual file validation anymore, since maven success/failure is really all we care about.</div>
<div><br></div><div><br></div><div>Lorin</div><div><br></div><div><br></div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Wed, Aug 7, 2013 at 3:28 PM, Sean Roberts <span dir="ltr"><<a href="mailto:seanrob@yahoo-inc.com" target="_blank">seanrob@yahoo-inc.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">



<div style="word-wrap:break-word">
I would rather as a stop gap just add the file in question to FILE_EXCEPTIONS and remove openstack-training from BOOK_EXCEPTIONS until someone more familiar with the validate.py code can debug the source of the problem.<div class="im">
<br>
<div>
<div style="font-size:medium;font-style:normal;font-variant:normal;font-weight:normal;letter-spacing:normal;line-height:normal;text-align:-webkit-auto;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;word-wrap:break-word">

<div style="font-size:14px;font-family:Calibri,sans-serif">
<span style="font-size:13px"><span style="font-family:Calibri;font-weight:bold;color:gray;margin:0px;padding:0px"><br>
<br>
</span></span></div>
<div style="font-size:14px;font-family:Calibri,sans-serif">
<span style="font-size:13px"><span style="font-family:Calibri;font-weight:bold;color:gray;margin:0px;padding:0px">Sean Roberts</span></span><span style="font-size:13px"><br>
</span><span style="font-size:13px"><span style="color:gray;font-family:Calibri;margin:0px;padding:0px">Infrastructure Strategy</span></span></div>
<div style="font-size:14px"><span style="font-size:13px"><font color="#808080" face="Calibri"><a href="mailto:seanrob@yahoo-inc.com" target="_blank">seanrob@yahoo-inc.com</a> </font></span><span style="color:gray;font-family:Calibri;font-size:13px">(925)
 980-4729</span></div>
</div>
</div>
<br>
</div><div>
<div>On Aug 7, 2013, at 12:15 PM, Sean Roberts <<a href="mailto:seanrob@yahoo-inc.com" target="_blank">seanrob@yahoo-inc.com</a>></div><div><div class="h5">
<div> wrote:</div>
<br>
<blockquote type="cite">
<div style="word-wrap:break-word">
validate.py is excluding openstack-training in build_all_books as well. Should I be changing 
<div><br>
<div><span style="line-height:18px;color:rgb(51,51,51);font-size:12px;white-space:pre-wrap;font-family:Consolas,'Liberation Mono',Courier,monospace">BOOK_EXCEPTIONS</span><span style="line-height:18px;color:rgb(51,51,51);font-size:12px;white-space:pre-wrap;font-family:Consolas,'Liberation Mono',Courier,monospace">
</span><span style="line-height:18px;color:rgb(51,51,51);font-size:12px;white-space:pre-wrap;font-family:Consolas,'Liberation Mono',Courier,monospace;font-weight:bold">=</span><span style="line-height:18px;color:rgb(51,51,51);font-size:12px;white-space:pre-wrap;font-family:Consolas,'Liberation Mono',Courier,monospace">
</span><span style="line-height:18px;color:rgb(51,51,51);font-size:12px;white-space:pre-wrap;font-family:Consolas,'Liberation Mono',Courier,monospace">[</span><span style="line-height:18px;color:rgb(221,17,68);font-size:12px;white-space:pre-wrap;font-family:Consolas,'Liberation Mono',Courier,monospace">'openstack-training'</span><span style="line-height:18px;color:rgb(51,51,51);font-size:12px;white-space:pre-wrap;font-family:Consolas,'Liberation Mono',Courier,monospace">] </span></div>

<div><span style="line-height:18px;color:rgb(51,51,51);font-size:12px;white-space:pre-wrap;font-family:Consolas,'Liberation Mono',Courier,monospace">to </span></div>
<div><span style="line-height:18px;color:rgb(51,51,51);font-size:12px;white-space:pre-wrap;font-family:Consolas,'Liberation Mono',Courier,monospace">BOOK_EXCEPTIONS</span><span style="line-height:18px;color:rgb(51,51,51);font-size:12px;white-space:pre-wrap;font-family:Consolas,'Liberation Mono',Courier,monospace">
</span><span style="line-height:18px;color:rgb(51,51,51);font-size:12px;white-space:pre-wrap;font-family:Consolas,'Liberation Mono',Courier,monospace;font-weight:bold">=</span><span style="line-height:18px;color:rgb(51,51,51);font-size:12px;white-space:pre-wrap;font-family:Consolas,'Liberation Mono',Courier,monospace">
</span><span style="line-height:18px;color:rgb(51,51,51);font-size:12px;white-space:pre-wrap;font-family:Consolas,'Liberation Mono',Courier,monospace">[</span><span style="line-height:18px;color:rgb(51,51,51);font-size:12px;white-space:pre-wrap;font-family:Consolas,'Liberation Mono',Courier,monospace">] </span></div>

<div><span style="line-height:18px;color:rgb(51,51,51);font-size:12px;white-space:pre-wrap;font-family:Consolas,'Liberation Mono',Courier,monospace"><br>
</span></div>
<div><span style="line-height:18px;color:rgb(51,51,51);font-size:12px;white-space:pre-wrap;font-family:Consolas,'Liberation Mono',Courier,monospace">as well as </span>
<div>
<pre style="font-family:Consolas,'Liberation Mono',Courier,monospace;font-size:12px;margin-top:0px;margin-bottom:0px;color:rgb(51,51,51);line-height:18px"><div style="padding-left:10px"><span style="font-weight:bold"><br>
</span></div><div style="padding-left:10px"><span style="font-weight:bold">def</span> <span style="color:rgb(153,0,0);font-weight:bold">main</span><span>(</span><span>rootdir</span><span>):</span></div><div style="padding-left:10px">
    <span>validate_individual_files</span><span>(</span><span>rootdir</span><span>,</span> <span>FILE_EXCEPTIONS</span><span>)</span></div><div style="padding-left:10px">    <span>build_all_books</span><span>(</span><span>rootdir</span><span>,</span> <span>BOOK_EXCEPTIONS</span><span>)</span></div>
</pre>
<div>to </div>
<div>
<pre style="font-size:12px;font-family:Consolas,'Liberation Mono',Courier,monospace;margin-top:0px;margin-bottom:0px;color:rgb(51,51,51);line-height:18px"><div style="padding-left:10px"><span style="font-weight:bold">def</span> <span style="color:rgb(153,0,0);font-weight:bold">main</span><span>(</span><span>rootdir</span><span>):</span></div>
<div style="padding-left:10px">    """ <span>validate_individual_files</span><span>(</span><span>rootdir</span><span>,</span> <span>FILE_EXCEPTIONS</span><span>) """</span></div><div style="padding-left:10px">
    <span>build_all_books</span><span>(</span><span>rootdir</span><span>,</span> <span>BOOK_EXCEPTIONS</span><span>)</span></div></pre>
<div><br>
</div>
</div>
<div><font color="#333333" face="Consolas, Liberation Mono, Courier, monospace"><span style="line-height:18px;white-space:pre-wrap"><br>
</span></font>
<div>
<div style="font-size:medium;font-style:normal;font-variant:normal;font-weight:normal;letter-spacing:normal;line-height:normal;text-align:-webkit-auto;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;word-wrap:break-word">

<div style="font-family:Calibri,sans-serif;font-size:14px"><span style="font-size:13px"><span style="font-family:Calibri;font-weight:bold;color:gray;margin:0px;padding:0px"><br>
<br>
</span></span></div>
<div style="font-family:Calibri,sans-serif;font-size:14px"><span style="font-size:13px"><span style="font-family:Calibri;font-weight:bold;color:gray;margin:0px;padding:0px">Sean Roberts</span></span><span style="font-size:13px"><br>

</span><span style="font-size:13px"><span style="color:gray;font-family:Calibri;margin:0px;padding:0px">Infrastructure Strategy</span></span></div>
<div style="font-size:14px"><span style="font-size:13px"><font color="#808080" face="Calibri"><a href="mailto:seanrob@yahoo-inc.com" target="_blank">seanrob@yahoo-inc.com</a> </font></span><span style="color:gray;font-family:Calibri;font-size:13px">(925)
 980-4729</span></div>
</div>
</div>
<br>
<div>
<div>On Aug 7, 2013, at 11:58 AM, Lorin Hochstein <<a href="mailto:lorin@nimbisservices.com" target="_blank">lorin@nimbisservices.com</a>></div>
<div> wrote:</div>
<br>
<blockquote type="cite">
<div dir="ltr">Sean:
<div><br>
</div>
<div>If the XML validation is giving a false positive, I suggest we turn it off. The validate.py script now uses maven to build all of the books.  Just remove the call to validate_individual_files in the "main" function.</div>

<div><br>
</div>
<div><br>
</div>
<div>Lorin</div>
</div>
<div class="gmail_extra"><br>
<br>
<div class="gmail_quote">On Wed, Aug 7, 2013 at 2:38 PM, Sean Roberts <span dir="ltr">
<<a href="mailto:seanrob@yahoo-inc.com" target="_blank">seanrob@yahoo-inc.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div style="word-wrap:break-word">I have a validate.py problem, anyone up for debugging with me?<br>
Local maven runs clean
<div><br>
</div>
<div>jenkins fails <a href="http://logs.openstack.org/50/40550/1/check/gate-openstack-manuals-validate/e3d606e/console.html" target="_blank">http://logs.openstack.org/50/40550/1/check/gate-openstack-manuals-validate/e3d606e/console.html</a></div>

<div>
<pre>...</pre>
<pre>+ ./tools/validate.py
/home/jenkins/workspace/gate-openstack-manuals-validate/doc/src/docbkx/openstack-training/bk001-ch003-associate-general.xml:5:0:ERROR:RELAXNGV:RELAXNG_ERR_ELEMNAME: Expecting element section, got chapter
/home/jenkins/workspace/gate-openstack-manuals-validate/doc/src/docbkx/openstack-training/bk001-ch003-associate-general.xml:13:0:ERROR:RELAXNGV:RELAXNG_ERR_EXTRACONTENT: Element chapter has extra content: include
/home/jenkins/workspace/gate-openstack-manuals-validate/doc/src/docbkx/openstack-training/bk001-ch003-associate-general.xml:9:0:ERROR:RELAXNGV:RELAXNG_ERR_ELEMWRONG: Did not expect element para there
/home/jenkins/workspace/gate-openstack-manuals-validate/doc/src/docbkx/openstack-training/bk001-ch003-associate-general.xml:5:0:ERROR:RELAXNGV:RELAXNG_ERR_ELEMWRONG: Did not expect element chapter there
/home/jenkins/workspace/gate-openstack-manuals-validate/doc/src/docbkx/openstack-training/bk001-ch003-associate-general.xml:5:0:ERROR:RELAXNGV:RELAXNG_ERR_ELEMNAME: Expecting element set, got chapter
...</pre>
<span><font color="#888888">
<div><br>
</div>
<div>
<div style="font-size:medium;font-style:normal;font-variant:normal;font-weight:normal;letter-spacing:normal;line-height:normal;text-align:-webkit-auto;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;word-wrap:break-word">

<div style="font-size:14px;font-family:Calibri,sans-serif"><span style="font-size:13px"><span style="font-family:Calibri;font-weight:bold;color:gray;margin:0px;padding:0px"><br>
<br>
</span></span></div>
<div style="font-size:14px;font-family:Calibri,sans-serif"><span style="font-size:13px"><span style="font-family:Calibri;font-weight:bold;color:gray;margin:0px;padding:0px">Sean Roberts</span></span><span style="font-size:13px"><br>

</span><span style="font-size:13px"><span style="color:gray;font-family:Calibri;margin:0px;padding:0px">Infrastructure Strategy</span></span></div>
<div style="font-size:14px"><span style="font-size:13px"><font color="#808080" face="Calibri"><a href="mailto:seanrob@yahoo-inc.com" target="_blank">seanrob@yahoo-inc.com</a> </font></span><span style="color:gray;font-family:Calibri;font-size:13px"><a href="tel:%28925%29%20980-4729" value="+19259804729" target="_blank">(925) 980-4729</a></span></div>

</div>
</div>
<br>
</font></span></div>
</div>
<br>
_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org" target="_blank">Openstack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
<br>
</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>
</blockquote>
</div>
<br>
</div>
</div>
</div>
</div>
</div>
_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org" target="_blank">Openstack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</blockquote>
</div></div></div>
<br>
</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>