W3C home > Mailing lists > Public > public-rdf-comments@w3.org > March 2013

Re: Editorial comment: Please use ALL CAPS for conformance words SHOULD, MUST, etc.

From: David Booth <david@dbooth.org>
Date: Fri, 01 Mar 2013 15:32:04 -0500
Message-ID: <51311044.4060304@dbooth.org>
To: Markus Lanthaler <markus.lanthaler@gmx.net>
CC: 'public-rdf-comments' <public-rdf-comments@w3.org>, 'Richard Cyganiak' <richard@cyganiak.de>
Thanks Markus, but I'm not seeing italic conformance words in the latest 
Turtle draft at
https://dvcs.w3.org/hg/rdf/raw-file/default/rdf-turtle/index.html#

AFAICT, the latest Turtle draft has the same problem, as can be seen in 
this paste from the latest Turtle draft:

"The key words must, must not, required, should, should not, 
recommended, may, and optional in this specification are to be 
interpreted as described in [RFC2119]."

David


On 03/01/2013 07:13 AM, Markus Lanthaler wrote:
> FYI, my changes which fix this issue have been merged into ReSpec v3.1.46.
> You might wanna update ReSpec for the other drafts as well.. e.g. RDF
> Concepts (cc'ing Richard).
>
> Btw., Turtle uses lowercase italic letters in conformance words.
>
>
> --
> Markus Lanthaler
> @markuslanthaler
>
>
>
>> -----Original Message-----
>> From: David Booth [mailto:david@dbooth.org]
>> Sent: Wednesday, February 27, 2013 5:37 AM
>> To: public-rdf-comments
>> Subject: Editorial comment: Please use ALL CAPS for conformance words
>> SHOULD, MUST, etc.
>>
>> This is a comment on
>> https://dvcs.w3.org/hg/json-ld/raw-file/default/spec/latest/json-ld-
>> syntax/index.html#relationship-to-rdf
>>
>> Please write conformance words in ALL CAPITALS, like "SHOULD", "MUST",
>> etc., so that they still show up appropriately when passages are copied
>> and pasted, rather than assuming that the text will only be viewed in a
>> browser that renders those words using a "small capitals" font.  It is
>> important to be able to copy and paste passages into plain text email,
>> such as this message, and have those words stand out appropriately.
>> For
>> example, notice how the word "should" does NOT appear in caps when
>> copied from the spec and pasted below, even though many browsers will
>> render it in small caps:
>>
>>     "IRIs used within a JSON-LD graph should return . . . "
>>                                       ^^^^^^
>> Thanks,
>> David
>
>
>
>
>
Received on Friday, 1 March 2013 20:32:32 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:29:55 UTC