Open Stack

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.

Thanks,
Anne




On Wed, Aug 28, 2013 at 2:24 PM, Lorin Hochstein
<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>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
>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>>
>
>
>
> --
> Lorin Hochstein
> Lead Architect - Cloud Services
> Nimbis Services, Inc.
> www.nimbisservices.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/8ae6f46c/attachment-0001.html>