updated makespec

Makefile

@@ -1,7 +1,9 @@
+TITLE	= Document Service Ontology (DSO)
+AUTHOR	= Jakob Voß (VZG)
+
 NAME=dso
 GITHUB=http://github.com/gbv/dso/
 FORMATS=ttl owl
 
 include makespec/Makefile
 
-

README.md

@@ -4,33 +4,27 @@ The URI of this ontology is going to be <http://purl.org/ontology/dso> and it's
 URI namespace is going to be <http://purl.org/ontology/dso#> (not registered
 yet).
 
-# Feedback
+The current version of this specification can be found at <http://gbv.github.io/dso/>
+and a public git repository at <https://github.com/gbv/dso>.
+[Feedback](https://github.com/gbv/dso/issues) is welcome!
+
+The following diagram illustrates the classes and properties defined in this ontology.
+
+~~~
+    +---------------------+
+    |  dso:ServiceEvent   |
+    | +-----------------+ |  hasDocument    +-----------------------+
+    | | DocumentService |------------------>| ...any document class |
+    | |                 |<------------------|                       |
+    | |  Loan           | |  hasService     +-----------------------+
+    | |  Presentation   | |
+    | |  Interloan      | |
+    | |  OpenAccess     | |
+    | |  Digitization   | |
+    | |  Identification | |
+    | |  ...            | |
+    | +-----------------+ |
+    +---------------------+
+~~~
 
-Feedback is welcome most in form of git pull requests or tracked issues:
-
-* https://github.com/gbv/dso/issues
-
-# Development
-
-The ontology is created by *document driven development* using
-[makespec](https://github.com/jakobib/makespec). The source file `dso.md` is written in [Pandoc
-Markdown](http://johnmacfarlane.net/pandoc/demo/example9/pandocs-markdown.html).
-Both the RDF serialization in RDF/Turtle (or RDF/XML) and the documentation in
-HTML are automatically derived from this source file. This requires:
-
-* [Pandoc](http://johnmacfarlane.net/pandoc/), at least 1.9
-* [Rapper](http://librdf.org/raptor/rapper.html) from Raptor RDF library
-
-All rules are included in `Makefile`. Just call `make` to (re)create everything, 
-or `make html`, `make ttl`, `make owl` to only create selected parts.
-
-To clone this repository:
-
-    git clone git://github.com/gbv/dso.git
-    git submodule update --init
-
-To also clone the HTML version branch, which is presented at
-<http://gbv.github.com/dso>:
-
-    git checkout -b gh-pages origin/gh-pages
 

dso.md

@@ -1,7 +1,3 @@
-% Document Service Ontology (DSO)
-% Jakob Voß (VZG)
-% GIT_REVISION_DATE
-
 # Introduction
 
 The **Document Service Ontology (DSO)** is a micro-ontology that defines a set
@@ -18,7 +14,11 @@ Markdown syntax. Sources and updates are available at
 modified at GIT_REVISION_DATE with revision GIT_REVISION_HASH.
 
 The current version of this ontology is a preliminary draft for open
-discussion.
+discussion. [Feedback](https://github.com/gbv/dso/issues) is welcome!
+
+**Revision history**
+
+GIT_CHANGES
 
 ## Terminology
 
@@ -206,7 +206,6 @@ services defined in DSO have earlier been defined as part of the DAIA ontology,
 which now makes use of DSO. The core concept of a service is based on the definition
 of a service event in the Simple Service Status Ontology (SSSO).
 
-
 # References
 
 ## Normative References
@@ -225,5 +224,6 @@ of a service event in the Simple Service Status Ontology (SSSO).
 * **[DAIA]** J. Voß: *Document Availability Information API (DAIA)*.
   Work in progress at <http://gbv.github.com/daiaspec/>.
 
-* ...
+* **[PAIA]** J. Voß: *Patrons Account Information API*. 2013.
+  Work in progress at <http://purl.org/ontology/paia>.