<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Wed, Aug 28, 2013 at 4:21 PM, Tom Fifield <span dir="ltr"><<a href="mailto:tom@openstack.org" target="_blank">tom@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 class="im">On 29/08/13 06:02, Anne Gentle wrote:<br>
> Thanks Lorin and David.<br>
><br>
> I talked to David today about my general concerns with maintaining our<br>
> own RNG file when a standard could be what we want. So I'm glad that a<br>
> DocBook 5.1 candidate is out!<br>
><br>
> I do want to caution reviewers that we have to make a judgement call<br>
> about super-fine-grained inclusions. Sometimes reuse is not the best<br>
> solution and rewriting would be better. Sometimes reuse IS the solution<br>
> and you should rewrite something generically for re-use in multiple<br>
> places. With many contributors looking at the repo for the first time,<br>
> it's a fine line to walk, to make sure we have good judgement calls on<br>
> reuse.<br>
<br>
</div>This sounds like a very reasonable approach/wording - should we dump<br>
that on a wiki somewhere?<br>
<div class="im"><br></div></blockquote><div><br></div><div>Yep, ML post sent to add a Reviewer Guidelines section to /Documentation/HowTo.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div class="im">
> Thanks,<br>
> Anne<br>
><br>
><br>
><br>
><br>
> On Wed, Aug 28, 2013 at 2:24 PM, Lorin Hochstein<br>
</div><div class="im">> <<a href="mailto:lorin@nimbisservices.com">lorin@nimbisservices.com</a> <mailto:<a href="mailto:lorin@nimbisservices.com">lorin@nimbisservices.com</a>>> wrote:<br>
><br>
> All right, let's give it a shot: <a href="https://review.openstack.org/44134" target="_blank">https://review.openstack.org/44134</a><br>
><br>
> Lorin<br>
><br>
><br>
><br>
> On Wed, Aug 28, 2013 at 3:08 PM, David Cramer<br>
</div><div><div class="h5">> <<a href="mailto:david.cramer@rackspace.com">david.cramer@rackspace.com</a> <mailto:<a href="mailto:david.cramer@rackspace.com">david.cramer@rackspace.com</a>>> wrote:<br>
><br>
> 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<br>
> log a bug.<br>
><br>
> Regards,<br>
> David<br>
><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<br>
> to happen<br>
> >> at the gate, yes. I'm saying I want us all to agree to the<br>
> .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<br>
> really want.<br>
> >> I'm currently not in agreement with David Cramer about what<br>
> 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<br>
> 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<br>
> file names<br>
> >> with colons and parens and slashes in them, and won't<br>
> validate any way,<br>
> >> even if the section is added, until those file names are<br>
> 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<br>
> get Tom<br>
> >> unblocked but he'll have to pick up where he left off and<br>
> change those<br>
> >> file names as well.<br>
> >><br>
> >> Thanks,<br>
> >> Anne<br>
> ><br>
> > Thanks Anne for the detailed explanation, this is a good<br>
> approach forward,<br>
> ><br>
> > Andreas<br>
> ><br>
><br>
><br>
> _______________________________________________<br>
> Openstack-docs mailing list<br>
> <a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
</div></div>> <mailto:<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a>><br>
<div class="im">> <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>
><br>
><br>
><br>
> --<br>
> Lorin Hochstein<br>
> Lead Architect - Cloud Services<br>
> Nimbis Services, Inc.<br>
</div>> <a href="http://www.nimbisservices.com" target="_blank">www.nimbisservices.com</a> <<a href="http://www.nimbisservices.com" target="_blank">http://www.nimbisservices.com</a>><br>
<div class="im">><br>
> _______________________________________________<br>
> Openstack-docs mailing list<br>
> <a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
</div>> <mailto:<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a>><br>
<div class="im">> <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>
><br>
><br>
><br>
> --<br>
> Anne Gentle<br>
</div>> <a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a> <mailto:<a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a>><br>
<div class="HOEnZb"><div class="h5">><br>
><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>
<br>
</div></div></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></div>