[occi-wg] Final round of comments for Use case and req. document before submission

[Sam Johnston]

On Tue, Sep 8, 2009 at 6:34 PM, Andy Edmonds <andy at edmonds.be> wrote:

> It'd be great if we had something like this -  I've comments, both my own
> and comments extracted from the mailing list, that need to be integrated in
> the context of the specification's content. I don't see any elegant way that
> DocBook supports this other than an obvious text insertion.


So it turns out that pasting the HTML document into co-ment.net's rich text
editor works nicely. My problem then is that we don't want to release a
draft and sit on our hands for a month, rather incorporate feedback as we
go. Perhaps the best way is to submit a new version weekly (say on Monday)
and use it to gather comments in the lead up to and following on from the
wednesday calls.

The spec is coming along very quickly now I'm 100% devoted to the task and
have a decent revision control system - expect to be commenting on it
directly.

Sam


> On Tue, Sep 8, 2009 at 17:26, Sam Johnston <samj at samj.net> wrote:
>
>> On Tue, Sep 8, 2009 at 5:22 PM, Gary Mazz <garymazzaferro at gmail.com>wrote:
>>
>>> Thanks, comment will follow today.
>>>
>>> Does anyone know how to add line numbers to the docs for editing and
>>> commenting purposes ?
>>>
>>
>> I'm not sure but it is something I've thought about. There was a great web
>> annotation <http://en.wikipedia.org/wiki/Web_annotation> system for GPLv3
>> called stet <http://en.wikipedia.org/wiki/Stet_%28software%29> but it's
>> now dead and they recommend co-ment.net instead (which barfed on the
>> DocBook I fed it). Marginalia <http://www.geof.net/code/annotation/>looks pretty cool too but what would be amazing is a system like the one
>> we're using for the HTML 5 Working Drafts<http://www.whatwg.org/specs/web-apps/current-work/>which posts directly to BugZilla.
>>
>> Sam
>>
>> Thijs Metsch wrote:
>>> > a new version is available via occi-wg.org or the link below...
>>> >
>>> > Cheers,
>>> >
>>> > -Thijs
>>> >
>>> > On Mon, 2009-09-07 at 16:14 +0200, Thijs Metsch wrote:
>>> >
>>> >> Hi all,
>>> >>
>>> >> I would like to encourage you all to have a look at our first
>>> >> deliverable 'Requirements and Use Cases for a Cloud API'. I would ask
>>> to
>>> >> send you comments, ideas and thoughts by Friday. The document can be
>>> >> found here:
>>> >>
>>> >> http://forge.ogf.org/sf/go/doc15732
>>> >>
>>> >> Friday is not a 'real' deadline. But I will submit it into the OGF
>>> >> editor pipeline on Friday. Then it will go into a public review -
>>> after
>>> >> that it will be released as our first informal document.
>>> >>
>>> >> All the best,
>>> >>
>>> >> -Thijs
>>> >>
>>> >>
>>>
>>> _______________________________________________
>>> occi-wg mailing list
>>> occi-wg at ogf.org
>>> http://www.ogf.org/mailman/listinfo/occi-wg
>>>
>>
>>
>> _______________________________________________
>> occi-wg mailing list
>> occi-wg at ogf.org
>> http://www.ogf.org/mailman/listinfo/occi-wg
>>
>>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://www.ogf.org/pipermail/occi-wg/attachments/20090908/c2f5334f/attachment.html