Open Stack

On Wed, Aug 28, 2013 at 4:21 PM, Tom Fifield <tom at openstack.org> wrote:

> 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?
>
>
Yep, ML post sent to add a Reviewer Guidelines section to
/Documentation/HowTo.


>  > 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
> >
>
>


-- 
Anne Gentle
annegentle at justwriteclick.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20130828/3bb1402e/attachment.html>