Yoshio's review

Hi all,

I have to send regrets for the next telecon (for travelling to Boston).

I'm reviewing the SPARQL editor's draft and this is my comment so far:

Though I haven't read through all the part to be reviewd,
I feel need for clarifying the construction of the document:

(1) An example should be delimited with a preceding example number and some 
special
character telling the end of an example.

(2) There is considerable redunduncy (repetions), which may puzzle readers.
I prefer the style with definitions first and examples later.
Some terms are used before their definitions.

(3) Putting short headlines or keywords before paragraphs introducing new 
concepts
makes it clearer. I see some of them in section 10 and I want them to appear 
everywhere.

I know I should write in more concrete way, but I haven't enough time before
travelling.

I will report more line-by-line manner later, but I first want to know
what other people feel.

Best,
Yoshio
fukushige.yoshio@jp.panasonic.com
fuku@w3.org

Received on Monday, 29 November 2004 17:37:48 UTC