w3c / EasierRDF

Making RDF easy enough for most developers
267 stars 13 forks source link

provide self-contained, normative description #93

Open chiarcos opened 2 years ago

chiarcos commented 2 years ago

In terms of readability, a problem is that many aspects of current RDF standards are defined in external documents. In general, this is a great idea, as it eliminates redundancies and creates synergies, but it is problematic for the occasional user. Taking the SPARQL function REPLACE as an example, this is currently defined with reference to XPath fn:replace, but it order for it to work, users need to

The second, third and fourth step in this process are completely unnecessary (other than for formal reasons), and with decreasing relevance of XML standards they even become a major obstacle, so having a compact (maybe even non-normative) description of these aspects in a single, coherent document (https://en.wikibooks.org/wiki/SPARQL/Expressions_and_Functions is quite good at this, actually) will improve readability a lot.

TallTed commented 2 years ago

will improve readability a lot.

I daresay, will improve readability and usability a lot.