From 92c09ae5e050c83d4e832e5a5eb9788a734e330a Mon Sep 17 00:00:00 2001
From: Jakob Voss <voss@gbv.de>
Date: Wed, 10 Apr 2013 10:16:48 +0200
Subject: [PATCH] updated makespec

---
 Makefile |  4 +++-
 makespec |  2 +-
 paia.md  | 31 +++++++++++++++++++++++++++----
 3 files changed, 31 insertions(+), 6 deletions(-)

diff --git a/Makefile b/Makefile
index a2eb39b..d2b66bd 100644
--- a/Makefile
+++ b/Makefile
@@ -1,5 +1,7 @@
 NAME=paia
 GITHUB=http://github.com/gbv/paia/
-FORMATS=
+FORMATS=ttl owl
+REVISIONS=40
+TTLFORMAT=-ttl
 
 include makespec/Makefile
diff --git a/makespec b/makespec
index e58c403..b4ace58 160000
--- a/makespec
+++ b/makespec
@@ -1 +1 @@
-Subproject commit e58c40380bb5262d0e8bd0c9bb22b49d54c96290
+Subproject commit b4ace585d60c2e3c1a5d9086c95022b0a6e3e44d
diff --git a/paia.md b/paia.md
index 7258c3f..00d6a8b 100644
--- a/paia.md
+++ b/paia.md
@@ -10,7 +10,6 @@ and fees.  Its primary goal is to provide patron access for discovery
 interfaces and other third-party applications to integrated library system, as
 easy as possible.
 
-
 ## Status of this document
 
 The specification has been created collaboratively based on use cases and
@@ -18,10 +17,32 @@ taking into account existing related standards and products such as NISO
 Circulation Interchange Protocol (NCIP), \[X]SLNP, DLF-ILS recommendations, and
 VuFind ILS drivers among others.
 
-Updates and sources can be found at <http://github.com/gbv/paia>. The current
-version of this document was last modified at GIT_REVISION_DATE with revision
-GIT_REVISION_HASH.
+A preliminary version of PAIA has been specified in German as part of a
+[GBV](http://www.gbv.de/) project. This page should help to get a clean and
+useful specification in English before releasing PAIA 1.0.
+
+Updates and sources can be found in a public git repository at
+<http://github.com/gbv/paia>. The master file
+[paia.md](https://github.com/gbv/paia/blob/master/paia.md) is written in
+[Pandoc’s Markdown](http://johnmacfarlane.net/pandoc/demo/example9/pandocs-markdown.html).
+HTML version of the specification and PAIA ontology [in RDF/Turtle](paia.ttl) 
+and [in RDF/XML](paia.owl) are is genereted from the master file with
+[makespec](https://github.com/jakobib/makespec).
+
+**How to contribute**
+
+* Implement a PAIA server for your library system.
+* Implement a PAIA client that makes use of patron account information.
+* [Comment](https://github.com/gbv/paia/issues) on the specification.
+* Suggest [useful apps and mashups](https://github.com/gbv/paia/wiki/Use-cases) 
+  that make use of PAIA.
 
+**Revision history**
+
+The current version of this document was last modified at GIT_REVISION_DATE
+with revision GIT_REVISION_HASH.
+
+GIT_CHANGES
 
 ## Conformance requirements
 
@@ -796,6 +817,7 @@ model, which can be mapped to RDF among other expressions. The expression of
 PAIA in RDF is in an early phase of discussion. The following ontologies may be
 reused:
 
+~~~ {.ttl}
     @prefix bibo: <http://purl.org/ontology/bibo/> .
     @prefix daia: <http://purl.org/ontology/daia/> .
     @prefix foaf: <http://xmlns.com/foaf/0.1/> .
@@ -803,6 +825,7 @@ reused:
     @prefix sioc: <http://rdfs.org/sioc/ns#> .
     @prefix ssso: <http://purl.org/ontology/ssso> .
     @prefix particip: <http://purl.org/vocab/participation/schema#> .
+~~~
 
 The mapping to RDF includes the following core concepts: