Glad to hear of others taking a closer look at the MADS/RDF documentation.
We did provide 25 MADS/RDF examples at  for closer inspection. These all validate. These 25 examples are presented as RDF/XML, n-triples, and turtle. Moreover, the ntriples and turtle files were created from the RDF/XML using 'rapper.' They should also test as "OK" using the tool at .
The in-text examples are inserted as references for the documentation. Forgiving the fact that we omitted the opening and closing rdf:RDF tags, simply to reduce noise, I found two in-text examples that do not validate properly when you do place the rdf:RDF tags around the snippets. We'll get those two fixed. Despite these two problems, the RDF/XML snippets in the text of the documentation still operate as human-understandable references for the textual descriptions. Although I personally find RDF/XML to be surprisingly succinct (especially when considering rdf:Lists), I hear your point that variation, or alternate presentations, of the in-text examples might also be beneficial. Turtle is also pretty concise. I'll put a couple in next time.
Although we've endeavored to present the documentation in a rather clean HTML style (at least as seen by the end-user), we were concerned with copyright issues vis-a-vis the W3C's styling. We'll be updating the documentation soon; we'll see what we can do about styling.
Please let me know if you find validation issues with the 25 MADS/RDF examples at . FYI: Although the use of a default namespace has not been a problem in any of my tests, I intend to update the examples and not employ a default namespace.
From: Metadata Object Description Schema List [[log in to unmask]] On Behalf Of Jakob Voss [[log in to unmask]]
Sent: Thursday, February 17, 2011 04:47
To: [log in to unmask]
Subject: [MODS] Broken examples in MADS/RDF Documentation
A closer look at the MADS/RDF Documentation at
that the examples in the text are difficult to read and in most cases
broken (no valid RDF/XML). Could you please replace the example with
valid RDF/Turtle? Turtle is much better to read while RDF/XML is not
suitable for human contemplation. The examples seem to have been created
by hand, which is a Sisyphean task for RDF/XML.
I tried to fix the examples (with help of the great 'rapper' tool). I
also replaced the example-URIs with a 'http://example.org/' prefix,
because this is best practice for example URI/URLs.
Before the examples you should but a paragraph that shows the prefix
definitions, that I omitted from the examples below:
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix madsrdf: <http://id.loc.gov/ontologies/mads/2010/11#> .
Moreover I'd recommend to write the documentation in clean HTML the W3C
recommendation style, as described at
madsrdf:authoritativeLabel "United States--History--Civil War,
a madsrdf:Topic ;
a madsrdf:Authority, madsrdf:ComplexSubject .
a madsrdf:Temporal .
a madsrdf:Geographic .
a madsrdf:Authority, madsrdf:HierarchicalGeographic ;
madsrdf:authoritativeLabel "United States--New
a madsrdf:Country .
a madsrdf:State .
a madsrdf:County .
a madsrdf:City .
a madsrdf:Authority, madsrdf:Title ;
madsrdf:authoritativeLabel "Hello, Dolly!" ;
madsrdf:elementValue "Hello, Dolly!" ;
a madsrdf:Authority, madsrdf:NameTitle ;
madsrdf:authoritativeLabel "Herman, Jerry, 1933- Hello, Dolly!" ;
a madsrdf:Authority, madsrdf:PersonalName ;
madsrdf:authoritativeLabel "Herman, Jerry, 1933-" ;
madsrdf:elementValue "Herman, Jerry," ;
madsrdf:elementValue "1933-" ;
Jakob Vo▀ <[log in to unmask]>, skype: nichtich
Verbundzentrale des GBV (VZG) / Common Library Network
Platz der Goettinger Sieben 1, 37073 G÷ttingen, Germany
+49 (0)551 39-10242, http://www.gbv.de