Re: Your feedback on pre-LC prov-o

Thanks, Graham.

I've reopened it at http://www.w3.org/2011/prov/wiki/Review_of_prov-o_july_3_2012_for_last_call#Graham

And we'll try to find something that doesn't clutter while providing the guidance that you're looking for.

Regards,
Tim

On Jul 18, 2012, at 4:33 AM, Graham Klyne wrote:

> Tim,
> 
> I just checked this:
> [[
> (1) would it be possible for term names to be included in the table of contents?  I found some aspects the document could be difficult to navigate/cross-reference in printed form.
> 
> PENDING-REVIEW EDITORIAL http://aquarius.tw.rpi.edu/prov-wg/prov-o#prov-o-at-a-glance should be the "print-friendly index" that you're looking for. It is at the top of the document.
> ]]
> 
> Unfortunately, this doesn't really help, as there's no obvious ordering of the terms.   (Ideally, they would be page-numbered, but I recognize that HTML isn't very good for that kind of thing (I'm surprised that after all these years, HTML still doesn't support ToC generation as standard).  The compromise I usually make is to have a table of contents that matches the document layout, with section numbering, so I can use that as a kind of "map".  That you don't section-number the individual term descriptions is part of my problem.)
> 
> This is just an editorial issue, and rather depends how much you care about usability of the spec in print form.
> 
> #g
> --
> 
> On 17/07/2012 18:45, Timothy Lebo wrote:
>> Graham,
>> 
>> I've finished responding to all of your feedback [1] to prov-o.
>> 
>> http://aquarius.tw.rpi.edu/prov-wg/prov-o reflects all changes.
>> 
>> Please feel free to review our responses and the latest draft and make any more comments.
>> 
>> You may indicate your dissatisfaction by changing the designation to REOPENED (see the beginning of the page).
>> 
>> Regards,
>> Tim
>> 
>> [1] http://www.w3.org/2011/prov/wiki/Review_of_prov-o_july_3_2012_for_last_call#Graham
>> 
> 
>

Received on Wednesday, 18 July 2012 12:43:17 UTC