Re: PROV-ISSUE-444 (prov-o-to-last-call): Review PROV-O for last call [PROV-O HTML] from Timothy Lebo on 2012-07-10 (public-prov-wg@w3.org from July 2012)

From: Timothy Lebo <lebot@rpi.edu>
Date: Tue, 10 Jul 2012 16:43:59 -0400
To: Sam Coppens Ugent <sam.coppens@ugent.be>
Cc: Provenance Working Group <public-prov-wg@w3.org>
Message-Id: <C8620CBC-6608-4000-8385-21BC824D78DB@rpi.edu>

Sam (and WG),

I am getting conflicting suggestions for the ordering in section 3.3.

At least someone has suggested one of {table, example, diagram} to go first, so we can't please everyone.

I'm not sure how to resolve this. 

The current order of https://dvcs.w3.org/hg/prov/raw-file/default/ontology/Overview.html#description-qualified-terms is:

* intro with one abstract pattern
* tables of all abstract patterns
* transition that ties tables to illustrations to cross reference (with two abstract examples)
* two concrete examples
* two abstract examples
* diagram of all abstract patterns.
* four concrete examples

Any discussion welcome.

Regards,
Tim

On Jul 9, 2012, at 5:15 PM, Sam Coppens Ugent wrote:

> Section 3.3: Qualified Terms
> 
> I would consider putting the example before the two tables listing the properties that can be qualified. This makes the section easier to read and to understand, otherwise you get the tables right away and get lost in them.

Received on Tuesday, 10 July 2012 20:44:27 UTC