schema: Add link to owLint, fix a couple of issues it found

Change-Id: I06e47cb52ca81160dd82c737b6ced268a9ff920e

1 files changed, 19 insertions, 7 deletions

diff --git a/schema/baserock-example.schema b/schema/baserock-example.schema
index 31134e4e..1fcd4834 100644
--- a/schema/baserock-example.schema
+++ b/schema/baserock-example.schema
@@ -25,16 +25,25 @@
 # Visualise it in a rubbish way:
 #  rapper -i turtle -o dot baserock-example.schema | dot -Tpng > schema.png
 #
-# Rapper is part of the 'raptor2' package on most distros.
-# See: http://librdf.org/
+# (Rapper is part of the 'raptor2' package on most distros.
+#  See: http://librdf.org/)
+#
+# Check for common mistakes:
+#  ln -s ./baserock-example.schema ./baserock-example.owl
+#  cd /path/to/owllint
+#  sbt "run /path/to/baserock/definitions/schema"
+#
+# (owLint is a tool written in Scala, it is likely not packaged for your
+#  distro, but if you install Scala and the `sbt` build tool, you can build
+#  and run it from sources at https://github.com/Samangan/owLint).
 #
 # Edit with Protégé:
 #  just open it in protege, it can save to Turtle format as well but will lose
 #  comments and formatting.
 #
-# Protégé is a Java application for editing OWL ontologies. I prefer to edit
-# them as Turtle text files but maybe you like compex GUIs.
-# See: http://protege.stanford.edu/products.php#desktop-protege
+# (Protégé is a Java application for editing OWL ontologies. I prefer to edit
+#  them as Turtle text files but maybe you like compex GUIs.
+#  See: http://protege.stanford.edu/products.php#desktop-protege)
 #
 # Browse it using the example browser program.
 #   See: browser/README.txt
@@ -61,10 +70,13 @@
 @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
 @prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
 @prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
-@prefix dc: <http://purl.org/dc/terms/> .
+@prefix dc: <http://purl.org/dc/elements/1.1/> .
 
 : a owl:Ontology ;
-  rdfs:comment "Example schema for Baserock Definitions format version 5." .
+  dc:title "Example schema for Baserock Definitions format version 5." ;
+  dc:creator "The Baserock Project" ;
+  # Versioned according to Semantic Versioning http://www.semver.org/
+  owl:versionInfo "0.1.0" .
 
 
 ## Entities