<div dir="ltr">Thanks Lorin and David. <div><br></div><div>I talked to David today about my general concerns with maintaining our own RNG file when a standard could be what we want. So I'm glad that a DocBook 5.1 candidate is out! </div>
<div><br></div><div>I do want to caution reviewers that we have to make a judgement call about super-fine-grained inclusions. Sometimes reuse is not the best solution and rewriting would be better. Sometimes reuse IS the solution and you should rewrite something generically for re-use in multiple places. With many contributors looking at the repo for the first time, it's a fine line to walk, to make sure we have good judgement calls on reuse. </div>
<div><br></div><div>Thanks,</div><div>Anne</div><div><br></div><div><br></div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Wed, Aug 28, 2013 at 2:24 PM, 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">All right, let's give it a shot: <a href="https://review.openstack.org/44134" target="_blank">https://review.openstack.org/44134</a><span class="HOEnZb"><font color="#888888"><div>
<br></div><div>Lorin</div><div><br></div></font></span></div><div class="gmail_extra"><br><br><div class="gmail_quote"><div><div class="h5">
On Wed, Aug 28, 2013 at 3:08 PM, David Cramer <span dir="ltr"><<a href="mailto:david.cramer@rackspace.com" target="_blank">david.cramer@rackspace.com</a>></span> wrote:<br></div></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div><div class="h5">
Btw., we might test with CR1 of the 5.1 schema:<br>
<br>
<a href="http://docbook.org/xml/5.1CR1/rng/" target="_blank">http://docbook.org/xml/5.1CR1/rng/</a><br>
<br>
Specifically:<br>
<a href="http://docbook.org/xml/5.1CR1/rng/docbookxi.rng" target="_blank">http://docbook.org/xml/5.1CR1/rng/docbookxi.rng</a><br>
<br>
That should fix the problem. If it doesn't, then we will want to log a bug.<br>
<br>
Regards,<br>
David<br>
<div><br>
On 08/27/2013 12:04 AM, Andreas Jaeger wrote:<br>
> On 08/26/2013 11:13 PM, Anne Gentle wrote:<br>
>> [...]<br>
>> Our gate runs tools/validate.py, true, and we need validation to happen<br>
>> at the gate, yes. I'm saying I want us all to agree to the .rng schema<br>
>> not just put in a terribly forgiving one.<br>
>><br>
>> I want a bigger view and more time to think through what we really want.<br>
>> I'm currently not in agreement with David Cramer about what should be<br>
>> xi:included -- it's really hard to maintain XML that points to<br>
>> fine-grained inclusions if you're not the only author or you don't sit<br>
>> next to each other and so on. So I am wanting a wider window for<br>
>> considerations for our global contributor base.<br>
>><br>
>> I also want everyone to know that this particular patch has file names<br>
>> with colons and parens and slashes in them, and won't validate any way,<br>
>> even if the section is added, until those file names are changed. Since<br>
>> the files are auto-generated, we'll need to change the file name<br>
>> generation portion as well. I've patched the patch to try to get Tom<br>
>> unblocked but he'll have to pick up where he left off and change those<br>
>> file names as well.<br>
>><br>
>> Thanks,<br>
>> Anne<br>
><br>
> Thanks Anne for the detailed explanation, this is a good approach forward,<br>
><br>
> Andreas<br>
><br>
<br>
<br>
</div></div></div><div class="im"><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>
</div></div></div></blockquote></div><br><br clear="all"><div class="im"><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>
<br>_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org">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>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>
</div>