Re: [QB] Last Call document draft

Dave,

Here are my comments. Some of them I already mentioned in the call.

Best,
Richard



Remove the headline of sub-heading 2.1 "A Data Cube Vocabulary", just leave these paragraphs directly as the start of Section 2.

Remove "This section is non-normative" from sub-sections 2.2-2.5. It's redundant since the entire Section is non-normative.

Remove the Note in 2.3 regarding SDMX 2.1.

Propose dropping Section 2.4, "Relationship to SCOVO", as it's really only of historical interest right now. If you find this is too controversial at this stage, add a note along these lines: "At Risk: While this subsection provided useful context when this specification was first drafted, the editors feel that it is now only of historical interest and perhaps best removed in the interest of brevity." If removed, perhaps add a bit to the Acknowledgements: "Data Cube was motivated by a desire to improve on earlier work in the area of representing statistical data in RDF. The SCOVO specification, written by Danny Ayers, Lee Feigenbaum, Wolfgang Halb, Michael Hausenblas, Tom Heath and Yves Raimond, was a noteworthy inspiration."

Rename Section 3. "Namespaces" to "Namespaces and Document Conventions", and move the contents of 2.6 "Document conventions" into the section. The result would be that all sub-sections of 2 are non-normative.

Section 3 needs to add a mapping for the eg: prefix, perhaps to http://example.org/ns# or somesuch. Just to make clear that eg: is really just an example prefix.

I'd prefer if the table in Section 3 started with the qb: prefix. It's currently not in the table, but mentioned only in a prose sentence below the table. That is kind of easy to miss, and the namespace URI is a really important piece of information.

I edited the document and removed the <h2>Conformance</h2> title from the markup in Section 4. We had two headlines there, because ReSpec automatically adds the headline for the section that has id="conformance".

Propose to move Section 6 "An example" to 5.3.

Propose to rename 12 "Abbreviation and normalization" to "Abbreviated and normalized data cubes".

Propose to remove the term "flattened" from Section 12 (and everywhere else it's mentioned), use the better term "normalized" instead. So we have "abbreviated" and "normalized" cubes.

Add a note to 12.1 saying it's At Risk. Move last paragraph before the 12.1 headline into 12.1 to make things more self-contained.



On 5 Mar 2013, at 14:28, Dave Reynolds wrote:

> I've released what I hope is a reasonable initial candidate for the Last Call WD for the Data Cube vocabulary. This is preparation for the vote on Thursday.
> 
> https://dvcs.w3.org/hg/gld/raw-file/default/data-cube/index.html
> 
> I'll send a separate note around on where we are with the various issues. However, I think this draft resolves each of the issues in the way discussed in the separate email threads.
> 
> Richard please check this. Feel free to fix minor problems or ask me to. Major problems should probably be raised on the list.
> 
> Benedikt - thanks for volunteering to do a review check. Please let us know of any problems that you spot.
> 
> The most substantial change from the last WD is the section on criteria for well-formed Data Cubes (ISSUE-29 [1]). The criteria discussions have been on the list. The SPARQL queries which are provided (to back up the narrative descriptions of the criteria) have all been checked on at least some positive and negative examples. The code for this is in the same repository where the vocabulary source sits [2].
> 
> I have one more task before putting down the edit token, which is to find a way to have a "Contributors" section to list Jeni, rather than leave here in the Acknowledgements.
> 
> Dave
> 
> [1] http://www.w3.org/2011/gld/track/issues/29
> 
> [2] https://code.google.com/p/publishing-statistical-data/
>

Received on Thursday, 7 March 2013 16:14:41 UTC