Open Stack

On 29/08/13 06:02, Anne Gentle wrote:
> Thanks Lorin and David. 
> 
> 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! 
> 
> 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. 

This sounds like a very reasonable approach/wording - should we dump
that on a wiki somewhere?

> Thanks,
> Anne
> 
> 
> 
> 
> On Wed, Aug 28, 2013 at 2:24 PM, Lorin Hochstein
> <lorin at nimbisservices.com <mailto:lorin at nimbisservices.com>> wrote:
> 
>     All right, let's give it a shot: https://review.openstack.org/44134
> 
>     Lorin
> 
> 
> 
>     On Wed, Aug 28, 2013 at 3:08 PM, David Cramer
>     <david.cramer at rackspace.com <mailto:david.cramer at rackspace.com>> wrote:
> 
>         Btw., we might test with CR1 of the 5.1 schema:
> 
>         http://docbook.org/xml/5.1CR1/rng/
> 
>         Specifically:
>         http://docbook.org/xml/5.1CR1/rng/docbookxi.rng
> 
>         That should fix the problem. If it doesn't, then we will want to
>         log a bug.
> 
>         Regards,
>         David
> 
>         On 08/27/2013 12:04 AM, Andreas Jaeger wrote:
>         > On 08/26/2013 11:13 PM, Anne Gentle wrote:
>         >> [...]
>         >> Our gate runs tools/validate.py, true, and we need validation
>         to happen
>         >> at the gate, yes. I'm saying I want us all to agree to the
>         .rng schema
>         >> not just put in a terribly forgiving one.
>         >>
>         >> I want a bigger view and more time to think through what we
>         really want.
>         >> I'm currently not in agreement with David Cramer about what
>         should be
>         >> xi:included -- it's really hard to maintain XML that points to
>         >> fine-grained inclusions if you're not the only author or you
>         don't sit
>         >> next to each other and so on. So I am wanting a wider window for
>         >> considerations for our global contributor base.
>         >>
>         >> I also want everyone to know that this particular patch has
>         file names
>         >> with colons and parens and slashes in them, and won't
>         validate any way,
>         >> even if the section is added, until those file names are
>         changed. Since
>         >> the files are auto-generated, we'll need to change the file name
>         >> generation portion as well. I've patched the patch to try to
>         get Tom
>         >> unblocked but he'll have to pick up where he left off and
>         change those
>         >> file names as well.
>         >>
>         >> Thanks,
>         >> Anne
>         >
>         > Thanks Anne for the detailed explanation, this is a good
>         approach forward,
>         >
>         > Andreas
>         >
> 
> 
>         _______________________________________________
>         Openstack-docs mailing list
>         Openstack-docs at lists.openstack.org
>         <mailto:Openstack-docs at lists.openstack.org>
>         http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
> 
> 
> 
> 
>     -- 
>     Lorin Hochstein
>     Lead Architect - Cloud Services
>     Nimbis Services, Inc.
>     www.nimbisservices.com <http://www.nimbisservices.com>
> 
>     _______________________________________________
>     Openstack-docs mailing list
>     Openstack-docs at lists.openstack.org
>     <mailto:Openstack-docs at lists.openstack.org>
>     http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
> 
> 
> 
> 
> -- 
> Anne Gentle
> annegentle at justwriteclick.com <mailto:annegentle at justwriteclick.com>
> 
> 
> _______________________________________________
> Openstack-docs mailing list
> Openstack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>