Re: PROV-ISSUE-210 (TLebo): 7.1 PROV-DM Interpretation diagram and interpretation definitions disorderly

Hi Tim,
I will implement your suggestions when I go through the document.
Luc

On 01/05/2012 06:19 PM, Provenance Working Group Issue Tracker wrote:
> PROV-ISSUE-210 (TLebo): 7.1 PROV-DM Interpretation diagram and interpretation definitions disorderly
>
> http://www.w3.org/2011/prov/track/issues/210
>
> Raised by: Timothy Lebo
> On product:
>
> The diagram at [1] illustrates subfigures a-h
>
> Below the figure, the definition of the illustrations are listed.
>
> For example, subfigure a "start-precedes-end" is followed by definition of "starts-precedes-end"
>
> Two readability (not content) issues:
>
> ISSUE A:
>
> Following the pattern above, I would expect the second definition after the diagram to be "generation-precedes-usage", but it is missing.
>
>
> ISSUE B:
>
> It is not clear, without in-depth reading, whether a definition is described in the narrative _above_ or _below_ the definition itself. This is compounded by ISSUE A above, where some definitions are missing. I suggest to begin the narrative describing the definition by referencing either the subfigure or the definition, e.g., "As in subfigure a, the following definition start-precedes-end ..."
>
> Thanks for your consideration.
>
> Regards,
> Tim
>
> [1] http://dvcs.w3.org/hg/prov/raw-file/default/model/ProvenanceModel.html#interpretation
>
>
>
>    

-- 
Professor Luc Moreau
Electronics and Computer Science   tel:   +44 23 8059 4487
University of Southampton          fax:   +44 23 8059 2865
Southampton SO17 1BJ               email: l.moreau@ecs.soton.ac.uk
United Kingdom                     http://www.ecs.soton.ac.uk/~lavm

Received on Wednesday, 11 January 2012 11:51:59 UTC