- From: Bob DuCharme <bob@snee.com>
- Date: Sun, 29 Nov 2020 11:01:11 -0500
- To: public-rdf-star@w3.org
- Message-ID: <a42cab5a-4f20-b26a-bc4f-26ee16ba968e@snee.com>
https://w3c.github.io/rdf-star/rdf-star-cg-spec.html looks great and I learned a lot. I have listed some suggestions with the more picky copyediting ones at the end. Thanks, Bob DuCHarme ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - "the purpose of this section will be to provide an informal introduction" How long do you want it? I could draft something. - Before Example 1, I would add this: "(In all examples, prefix declarations have been omitted for brevity.)" Even better: say "In most examples, prefix declarations..." and then include the prefix declaration in Example 4, which would be clearer with it. (Too many people think that there is something magic about certain common prefixes so that they don't need to be declared.) - Section 2. "is called an asserted triple" At this point in the document I was confused about how a triple could be in a dataset without being asserted. After I read section 6.2.1 I understood. I think that this paragraph could use something like "Non-asserted triples are discussed further in section 6.2.1". - "Each named graph is a pair consisting of an IRI or a blank node (the graph name), and an RDF* graph" This would be clearer as "Each named graph is a pair consisting of either an IRI or a blank node serving as the graph's name and an RDF* graph". This plays up the importance of role played by this IRI or blank node more. - Section 3.1 (and 4.2) "which replace the productions with the same number (any) in the original grammar". Saying "replace with X" implies that X is the replacement--in this case, the number itself, which I would read as meaning "amount" here. This would be better as "which replace the productions that were assigned the same numbers in the original grammar." - After the reference to "function eval(D(G), algebra expression)" there are two references to "function eval" without showing the parameters or any formatting of "eval" to show that it's a reference to a syntax expression (although I suppose a high-level one). I think saying "the eval function" instead of "function eval" would read better in those two references. Copyediting: - "allowing to represent" -> "allowing the representation of" - "a embedded" -> "an embedded" - "The subject and embSubject productions sets the curSubject" The sentence has a plural subject (pardon the overloading), so verb should be "set" and not "sets" - "nothing prevents other concrete syntaxes of RDF* to be proposed" -> "nothing prevents other concrete syntaxes of RDF* from being proposed" (or "nothing prevents the proposal of other RDF* concrete syntaxes") - "solution mappings: Two SPARQL*" lower-case "t" in "two" because it's all one sentence - "These embedded triple patterns are allowed in subject ([75], [81]) and object ([80], [105]) position of SPARQL* triple patterns" -> "...are allowed in *the* subject ... position*s* of..." - "Based on the SPARQL grammar the SPARQL specification" add comma after "grammar" - "is not in Ω)." Move period inside of parentheses because the entire sentence is inside of them - 4.4 after "following four properties:" the bulleted list looks like the conversion from a sentence to a bulleted list wasn't quite finished. The bulleted items shouldn't have the commas or "and" after them. See the numbered list in 6.1, although the 4.4 ones don't need a period because they're not complete sentences. - "semantics, in order" drop comma
Received on Sunday, 29 November 2020 16:01:28 UTC