Create specification folder (#75)

* chore: remove placeholder

* chore: correct reference definitions

* chore: create specifications folder

* chore: adjust links, readd diagrams

* chore: bring releases back to top level

.github/workflows/autopublish.yaml

@@ -18,12 +18,8 @@ jobs:
           node-version: 22.x
       - name: Copy files for correct web access
         run: |
-          mkdir ./message
-          mkdir ./figures
-          cp ./**/message/* -R ./message/
-          cp ./**/figures/*.png ./figures/
-          cp ./model/*.png .
-          cp ./releases/* . -r
+          chmod +x ./.github/workflows/script.sh
+          ./.github/workflows/script.sh
       - name: Run Respec
         run:
           sudo npx puppeteer browsers install chrome

.github/workflows/script.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+mkdir -p ./message/schema
+mkdir -p ./message/example
+mkdir -p ./message/diagram
+mkdir ./figures
+cp ./artifacts/src/main/resources/**/* ./message/schema || true
+echo "successfully copied message schemas"
+cp -R "./artifacts/src/main/resources"/**/"example"/* ./message/example
+echo "successfully copied message examples"
+cp -R "./specifications"/**/"message/diagram"/*".png" message/diagram
+echo "successfully copied message diagrams"
+cp -R "./specifications"/**/"figures"/*".png" ./figures/
+echo "successfully copied figures"
+cp -R "./releases"/** .
+echo "successfully copied releases"
+#rm -rf artifacts
+#echo "successfully removed artifacts"

.gitignore

@@ -7,8 +7,6 @@
 *.zip
 *.tar.gz
 *.rar
-# only top level images
-*.png
 
 .idea
 *.iml

README.md

@@ -13,11 +13,11 @@ This version ([2024-1](https://github.com/International-Data-Spaces-Association/
 
 ## Abstract
 
-The __Dataspace Protocol__ is a set of specifications designed to facilitate interoperable data sharing between entities governed by usage control and based on Web technologies. These specifications define the schemas and protocols required for entities to publish data, negotiate [Agreements](./model/terminology.md#agreement), and access data as part of a federation of technical systems termed a [Dataspace](./model/terminology.md#dataspace).
+The __Dataspace Protocol__ is a set of specifications designed to facilitate interoperable data sharing between entities governed by usage control and based on Web technologies. These specifications define the schemas and protocols required for entities to publish data, negotiate [Agreements](specifications/model/terminology.md#agreement), and access data as part of a federation of technical systems termed a [Dataspace](specifications/model/terminology.md#dataspace).
 
 
-* [Introduction to the Dataspace Protocol](./introduction.md)
-* [Scope of the Dataspace Protocol](./scope.md)
+* [Introduction to the Dataspace Protocol](specifications/common/introduction.md)
+* [Scope of the Dataspace Protocol](specifications/common/scope.md)
 
 ## Introduction
 

index.html

@@ -49,46 +49,46 @@ <h1 id="title">Dataspace Protocol</h1>
     </p>
 </section>
 
-<section data-include="foreword.md" data-include-format="markdown">
+<section class="notoc" data-include="specifications/common/foreword.md" data-include-format="markdown">
 </section>
 
-<section data-include="introduction.md" data-include-format="markdown">
+<section class="notoc" data-include="specifications/common/introduction.md" data-include-format="markdown">
 </section>
 
-<section data-include="scope.md" data-include-format="markdown">
+<section data-include="specifications/common/scope.md" data-include-format="markdown">
 </section>
 
-<section data-include="normative.references.md" data-include-format="markdown">
+<section data-include="specifications/common/normative.references.md" data-include-format="markdown">
 </section>
 
-<section data-include="model/terminology.md" data-include-format="markdown">
+<section data-include="specifications/model/terminology.md" data-include-format="markdown">
 </section>
 
-<section data-include="model/model.md" data-include-format="markdown">
+<section data-include="specifications/model/model.md" data-include-format="markdown">
 </section>
 
-<section data-include="common/common.protocol.md" data-include-format="markdown">
+<section data-include="specifications/common/common.protocol.md" data-include-format="markdown">
 </section>
 
-<section data-include="common/common.binding.https.md" data-include-format="markdown">
+<section data-include="specifications/common/common.binding.https.md" data-include-format="markdown">
 </section>
 
-<section data-include="catalog/catalog.protocol.md" data-include-format="markdown">
+<section data-include="specifications/catalog/catalog.protocol.md" data-include-format="markdown">
 </section>
 
-<section data-include="catalog/catalog.binding.https.md" data-include-format="markdown">
+<section data-include="specifications/catalog/catalog.binding.https.md" data-include-format="markdown">
 </section>
 
-<section data-include="negotiation/contract.negotiation.protocol.md" data-include-format="markdown">
+<section data-include="specifications/negotiation/contract.negotiation.protocol.md" data-include-format="markdown">
 </section>
 
-<section data-include="negotiation/contract.negotiation.binding.https.md" data-include-format="markdown">
+<section data-include="specifications/negotiation/contract.negotiation.binding.https.md" data-include-format="markdown">
 </section>
 
-<section data-include="transfer/transfer.process.protocol.md" data-include-format="markdown">
+<section data-include="specifications/transfer/transfer.process.protocol.md" data-include-format="markdown">
 </section>
 
-<section data-include="transfer/transfer.process.binding.https.md" data-include-format="markdown">
+<section data-include="specifications/transfer/transfer.process.binding.https.md" data-include-format="markdown">
 </section>
 
 <section id='conformance'></section>