<div dir="ltr">Hi all, <div>You may have noticed there has been a lot of discussion in reviews around the validation gate for openstack-manuals. Or perhaps you didn't notice, and that's why I'm talking about this on the list. I also need to straighten it out in my own mind. Writing helps. :)</div>


<div><p style="padding-top:0.5em;margin-bottom:0px;font-family:'Arial Unicode MS',Arial,sans-serif;margin-top:0px;padding-bottom:0.5em">I like the idea of categories of gating jobs. Some are voting, which means your patch will get a red X mark. Some are non-voting, which means your patch will get an informative message telling you some of your submission isn't right. </p>


<p style="padding-top:0.5em;margin-bottom:0px;font-family:'Arial Unicode MS',Arial,sans-serif;margin-top:0px;padding-bottom:0.5em">So I want to sort out what we want to test on new submissions:</p>
<p style="padding-top:0.5em;margin-bottom:0px;font-family:'Arial Unicode MS',Arial,sans-serif;margin-top:0px;padding-bottom:0.5em">This is the most important one: Do all the books build? If not which ones are problematic and why? Ideally the gate test will build only the books that have changed files. Is this happening now?<br>


</p><p style="padding-top:0.5em;margin-bottom:0px;font-family:'Arial Unicode MS',Arial,sans-serif;margin-top:0px;padding-bottom:0.5em">This is less important to me: Are we being careful about whitespace? If not which ones are failing the whitespace tests? <br>


</p><p style="padding-top:0.5em;margin-bottom:0px;font-family:'Arial Unicode MS',Arial,sans-serif;margin-top:0px;padding-bottom:0.5em">And this one is problematic: Do individual files validate? With xrefs in the source file, the files will not validate in Oxygen. To me, validation can be non-voting as long as the books build. </p>

<p style="padding-top:0.5em;margin-bottom:0px;font-family:'Arial Unicode MS',Arial,sans-serif;margin-top:0px;padding-bottom:0.5em">We can use 1.9.0 (or 1.9.2 when it's released) in the pom.xml but also the xlink markup would have to be changed. This isn't an overnight-flip-the-switch kind of change. We need to talk about policies. Let's have that discussion at the boot camp.<br>

</p><p style="padding-top:0.5em;margin-bottom:0px;font-family:'Arial Unicode MS',Arial,sans-serif;margin-top:0px;padding-bottom:0.5em">Also, we need the "Failed" messages about images to be fixed in the build tool in order to make these logs more useful. David, definitely move this bug up on your priority list. <a href="https://bugs.launchpad.net/openstack-manuals/+bug/1193491">https://bugs.launchpad.net/openstack-manuals/+bug/1193491</a></p>


<p style="padding-top:0.5em;margin-bottom:0px;font-family:'Arial Unicode MS',Arial,sans-serif;margin-top:0px;padding-bottom:0.5em">In the meantime, let's make sure whitespace remains non-voting.</p><p style="padding-top:0.5em;margin-bottom:0px;font-family:'Arial Unicode MS',Arial,sans-serif;margin-top:0px;padding-bottom:0.5em">

Any questions? I don't know if I clarified much but I wanted to ensure you know I'm paying attention and doing what I can to mitigate any difficulties getting good content through the gate. </p><p style="padding-top:0.5em;margin-bottom:0px;font-family:'Arial Unicode MS',Arial,sans-serif;margin-top:0px;padding-bottom:0.5em">

Thanks,</p><p style="padding-top:0.5em;margin-bottom:0px;font-family:'Arial Unicode MS',Arial,sans-serif;margin-top:0px;padding-bottom:0.5em">Anne</p></div></div>