From 5410e583fa42685f56b735bc55b4356a43efeb2b Mon Sep 17 00:00:00 2001
From: Jochen Schirrwagen <jochen.schirrwagen@uni-bielefeld.de>
Date: Thu, 29 Nov 2018 17:18:45 +0100
Subject: [PATCH] add information on XML schema and sample files

---
 docs/application_profile.rst | 19 ++++++++++++++++++-
 docs/introduction.rst        | 16 +++++++---------
 2 files changed, 25 insertions(+), 10 deletions(-)

diff --git a/docs/application_profile.rst b/docs/application_profile.rst
index a4b9fb9..7bc9b20 100644
--- a/docs/application_profile.rst
+++ b/docs/application_profile.rst
@@ -1,7 +1,7 @@
 .. _application_profile:
 
 Application Profile Overview
-----------------------------
+============================
 
 The properties of the Application Profile for OpenAIRE Literature Repository Guidelines are listed in this section.
 The following requirement levels for the metadata properties are used:
@@ -65,6 +65,23 @@ OpenAIRE-Field                           Metadata Element              Refinemen
 :ref:`dct:audience`                      dcterms:audience
 ======================================== ============================= ========================================================================================
 
+The application profile is implemented in XML Schema.
+`The files <https://github.com/openaire/guidelines-literature-repositories/tree/master/schemas>`_ 
+for the application profile and `sample XML files <https://github.com/openaire/guidelines-literature-repositories/tree/master/samples>`_ are part of these Guidelines and also available on the `GitHub repository <https://github.com/openaire/guidelines-literature-repositories>`_.
+
+In the XML metadata documents the schema must be declared as follows:
+
+.. code-block:: xml
+   :linenos:
+
+   <resource xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+     xmlns:dc="http://purl.org/dc/elements/1.1/"
+     xmlns:dcterms="http://purl.org/dc/terms/"
+     xmlns:datacite="http://datacite.org/schema/kernel-4"
+     xmlns="http://namespace.openaire.eu/schema/oaire/"
+     xsi:schemaLocation="http://namespace.openaire.eu/schema/oaire/ https://www.openaire.eu/schema/repo-lit/4.0/openaire.xsd">
+
 .. _COAR Resource Type Vocabulary: http://vocabularies.coar-repositories.org/documentation/resource_types/
 .. _COAR Access Right Vocabulary: http://vocabularies.coar-repositories.org/documentation/access_rights/
 .. _COAR Version Vocabulary: http://vocabularies.coar-repositories.org/documentation/version_types/
diff --git a/docs/introduction.rst b/docs/introduction.rst
index 7872376..728fbdc 100644
--- a/docs/introduction.rst
+++ b/docs/introduction.rst
@@ -1,10 +1,10 @@
 .. _literature_intro:
 
 Introduction
-------------
+============
 
 Aim
-^^^
+---
 The OpenAIRE Guidelines for Literature Repository Managers 4.0 provide
 orientation for repository managers to define and implement their local data
 management policies according to the requirements of the `OpenAIRE - Open Access
@@ -29,7 +29,7 @@ part of a set of OpenAIRE Guidelines that also include the OpenAIRE Guidelines
 for Data Archive Managers, the OpenAIRE Guidelines for CRIS managers, the OpenAIRE Guidelines for Software Repository Managers, and the Guidelines for Other Research Products Repository Managers.
 
 What's new
-^^^^^^^^^^
+----------
 In comparison with previous versions of the Guidelines, this version introduces
 the following major changes:
 
@@ -39,7 +39,7 @@ the following major changes:
 * compliance with the `OpenAIRE Content Acquisition Policy <https://doi.org/10.5281/zenodo.1446407>`_, published on 05-Oct-2018.
 
 How this document is structured
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+-------------------------------
 
 Chapter two provides a brief overview of how to configure and use OAI-PMH for OpenAIRE metadata harvesting.
 Chapter three describes the application profile.
@@ -52,10 +52,8 @@ Each OpenAIRE field is described in detail by
 * definition and usage instructions with regard to allowed values in properties, sub-properties and attributes
 * example(s)
 
-`XML Schema files <https://github.com/openaire/guidelines-literature-repositories/tree/master/schemas>`_ for the application profile and `sample XML files <https://github.com/openaire/guidelines-literature-repositories/tree/master/samples>`_ are part of these Guidelines but also available on the `GitHub repository <https://github.com/openaire/guidelines-literature-repositories>`_.
-
 Acknowledgements & Contributors
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+-------------------------------
 
 **Editors**
 
@@ -94,8 +92,8 @@ Acknowledgements & Contributors
 * Pierre Lasou (Université Laval, CA)
 
 Versions
-^^^^^^^^
-* 4.0, November 2018 `doi:10.5281/zenodo.1299203 <http://dx.doi.org/10.5281/zenodo.1299203>`
+--------
+* 4.0, November 2018 `doi:10.5281/zenodo.1299203 <http://dx.doi.org/10.5281/zenodo.1299203>`_
 
 * 4.0 draft, November 2017