W3C home > Mailing lists > Public > public-rdf-wg@w3.org > November 2012

Re: [Concepts] Proposing some informative Notes for deletion

From: Pat Hayes <phayes@ihmc.us>
Date: Mon, 12 Nov 2012 11:36:55 -0600
Cc: RDF Working Group WG <public-rdf-wg@w3.org>
Message-Id: <FB654189-B309-467B-8496-96AB245DA2FA@ihmc.us>
To: Richard Cyganiak <richard@cyganiak.de>

On Nov 9, 2012, at 7:10 AM, Richard Cyganiak wrote:

> ISSUE-104: Too many informative Notes in RDF Concepts
> https://www.w3.org/2011/rdf-wg/track/issues/104
> 
> In the words of Gavin: “There are sections which seem to completely overwhelm their content with notes.”

Note. Notes often happen becuase someone has commented on an earlier draft and has either asked for clarification or has obviously needed clarification. While they can be criticised on stylistic grounds, I think information is more important than style in a standards document. 

Pat

> 
> I've looked through the draft and identified some Notes that perhaps could simply be deleted, as they add little value. Value is subjective, so I might be way off. Nothing should be deleted without consensus, of course. On the other hand, if you'd like to nominate any other candidates for the bin, please do.
> 
> 
> 
> PROPOSAL: Delete the following informative Notes from RDF Concepts, as they seem to add little value.
> 
> 
> 
> [[
> Note: Literals in which the lexical form begins with a composing character (as defined by [CHARMOD]) are allowed however they may cause interoperability problems, particularly with XML version 1.1 [XML11].
> ]]
> http://dvcs.w3.org/hg/rdf/raw-file/default/rdf-concepts/index.html#note-composing-character
> 
> [[
> Note: When using the language tag, care must be taken not to confuse language with locale. The language tag relates only to human language text. Presentational issues should be addressed in end-user applications.
> ]]
> http://dvcs.w3.org/hg/rdf/raw-file/default/rdf-concepts/index.html#note-locale
> 
> [[
> Note: The case normalization of language tags is part of the description of the abstract syntax, and consequently the abstract behaviour of RDF applications. It does not constrain an RDF implementation to actually normalize the case. Crucially, the result of comparing two language tags should not be sensitive to the case of the original input.
> ]]
> http://dvcs.w3.org/hg/rdf/raw-file/default/rdf-concepts/index.html#note-langtag-normalization
> 
> [[
> Note: When the datatype is defined using XML Schema:
> • All values correspond to some lexical form, either using the lexical-to-value mapping of the datatype or if it is a union datatype with a lexical mapping associated with one of the member datatypes.
> • XML Schema facets remain part of the datatype and are used by the XML Schema mechanisms that control the lexical space and the value space; however, RDF does not define a standard mechanism to access these facets.
> • In [XMLSCHEMA11-1], white space normalization occurs during validation according to the value of the whiteSpace facet. The lexical-to-value mapping used in RDF datatyping occurs after this, so that the whiteSpace facet has no effect in RDF datatyping.
> ]]
> http://dvcs.w3.org/hg/rdf/raw-file/default/rdf-concepts/index.html#note-datatype-xml-schema
> (Maybe retain *some* of the bullet points here?)
> 
> [[
> Not all values of this datatype are compliant with XML 1.1 [XML11]. If compliance with XML 1.1 is desired, then only those values that are fully normalized according to XML 1.1 should be used.
> ]]
> http://dvcs.w3.org/hg/rdf/raw-file/default/rdf-concepts/index.html#note-xml11
> 
> 

------------------------------------------------------------
IHMC                                     (850)434 8903 or (650)494 3973   
40 South Alcaniz St.           (850)202 4416   office
Pensacola                            (850)202 4440   fax
FL 32502                              (850)291 0667   mobile
phayesAT-SIGNihmc.us       http://www.ihmc.us/users/phayes
Received on Monday, 12 November 2012 17:37:24 GMT

This archive was generated by hypermail 2.3.1 : Tuesday, 26 March 2013 16:25:52 GMT