From c205859f2e6824085738179792fbc232fbb32e4c Mon Sep 17 00:00:00 2001
From: Sebastian Steinbuss <23654606+ssteinbuss@users.noreply.github.com>
Date: Wed, 29 Jul 2026 17:59:16 +0200
Subject: [PATCH 1/6] feat(terminology): align dataspace definitions with
ISO/IEC FDIS 20151-1 (#266)
---
specifications/common/terminology.md | 36 +++++++++++++++++++++++++---
1 file changed, 33 insertions(+), 3 deletions(-)
diff --git a/specifications/common/terminology.md b/specifications/common/terminology.md
index 8545083..202bb7d 100644
--- a/specifications/common/terminology.md
+++ b/specifications/common/terminology.md
@@ -34,17 +34,29 @@ A set of interactions between a [=Provider=] and [=Consumer=] that establish an
A set of allowable [=Message Type=] sequences defined as a state machine.
+Data Sharing
+
+access to the same data by more than one authorized entity
+
+Note 1 to entry: Use of the data can be synchronous or asynchronous.
+
+Note 2 to entry: Data can be shared, for example, (i) by allowing access to, or the execution of operations over, the original dataset, or (ii) by giving a copy of the data to the interested entity.
+
+Note 3 to entry: The way in which data is shared fundamentally influences the available controls and the statements needed in a data sharing agreement.
+
+[SOURCE: ISO/IEC FDIS 20151-1]
+
Dataset
Data or a technical service that can be shared by a [=Participant=].
Dataspace
-governance framework and supporting services to build trustworthiness and enable the sharing of data through an agreed set of [=Policies=], semantic models, protocols and processes
+[=Environment=] enabling trusted [=Data Sharing=] between participating parties, based on an agreed [=Governance Framework=], along with an agreed set of [=Policies=], semantic models, standardized protocols, processes, and facilitating services
-[SOURCE: ISO/IEC 20151 to be published]
+[SOURCE: ISO/IEC FDIS 20151-1]
-Note 1 to entry: This specification covers only protocols to facilitate interoperable [=Dataset=] sharing between entities based on technical services. The overarching concepts and characteristics of Dataspaces are described in ISO/IEC 20151.
+Note 1 to entry: This specification covers only protocols to facilitate interoperable [=Dataset=] sharing between entities based on technical services. The overarching concepts and characteristics of Dataspaces are described in ISO/IEC FDIS 20151-1.
Dataspace Protocol
@@ -54,6 +66,24 @@ A set of Messages and Message sequences that enables the interaction between [=P
A set of rules and conventions that dictate how data is transmitted over a network by defining the format, error handling, and flow control. Examples include HTTP, FTP, MQTT, and AMQP.
+Environment
+
+context determining the setting and circumstances of all influences upon a system
+
+[SOURCE: ISO/IEC FDIS 20151-1]
+
+Governance
+
+human-based system comprising directing, overseeing and accountability
+
+[SOURCE: ISO/IEC 38500:2024, 3.3]
+
+Governance Framework
+
+strategies, policies, decision-making structures and accountabilities through which the organization's [=Governance=] arrangements operate
+
+[SOURCE: ISO/IEC FDIS 20151-1]
+
Message Type
A definition of the structure of a Message.
From aa5b102ee1ec15191d8931a370d7e06643f66b66 Mon Sep 17 00:00:00 2001
From: Sebastian Steinbuss <23654606+ssteinbuss@users.noreply.github.com>
Date: Thu, 27 Aug 2026 14:47:43 +0200
Subject: [PATCH 2/6] Update terminology.md
Adding note to entry on Agreement with requested clarification on machine procesability of policies and agreements.
---
specifications/common/terminology.md | 2 ++
1 file changed, 2 insertions(+)
diff --git a/specifications/common/terminology.md b/specifications/common/terminology.md
index 202bb7d..2d40d91 100644
--- a/specifications/common/terminology.md
+++ b/specifications/common/terminology.md
@@ -6,6 +6,8 @@ The following terms and definitions introduce the core concepts, entities, and r
A concrete [=Policy=] associated with a specific [=Dataset=] that has been agreed between the [=Provider=] and [=Consumer=]. It is a result of a [=Contract Negotiation=] defining the [=Policy=] agreed to for a [=Dataset=].
+Note 1 to entry: The policies agreed upon typically include machine-processable access and usage policies.
+
Catalog
A collection of entries representing [=Offers=] that are advertised by a [=Provider=].
From 5a792b15fe427f9e5e3a80a751946244158742fa Mon Sep 17 00:00:00 2001
From: Sebastian Steinbuss <23654606+ssteinbuss@users.noreply.github.com>
Date: Thu, 27 Aug 2026 14:56:17 +0200
Subject: [PATCH 3/6] Update terminology.md
Updating Defnition style. We use a full stop at the end.
---
specifications/common/terminology.md | 10 +++++-----
1 file changed, 5 insertions(+), 5 deletions(-)
diff --git a/specifications/common/terminology.md b/specifications/common/terminology.md
index 2d40d91..f03eadd 100644
--- a/specifications/common/terminology.md
+++ b/specifications/common/terminology.md
@@ -38,7 +38,7 @@ A set of allowable [=Message Type=] sequences defined as a state machine.
Data Sharing
-access to the same data by more than one authorized entity
+access to the same data by more than one authorized entity.
Note 1 to entry: Use of the data can be synchronous or asynchronous.
@@ -54,7 +54,7 @@ Data or a technical service that can be shared by a [=Participant=].
Dataspace
-[=Environment=] enabling trusted [=Data Sharing=] between participating parties, based on an agreed [=Governance Framework=], along with an agreed set of [=Policies=], semantic models, standardized protocols, processes, and facilitating services
+[=Environment=] enabling trusted [=Data Sharing=] between participating parties, based on an agreed [=Governance Framework=], along with an agreed set of [=Policies=], semantic models, standardized protocols, processes, and facilitating services.
[SOURCE: ISO/IEC FDIS 20151-1]
@@ -70,19 +70,19 @@ A set of rules and conventions that dictate how data is transmitted over a netwo
Environment
-context determining the setting and circumstances of all influences upon a system
+context determining the setting and circumstances of all influences upon a system.
[SOURCE: ISO/IEC FDIS 20151-1]
Governance
-human-based system comprising directing, overseeing and accountability
+human-based system comprising directing, overseeing and accountability.
[SOURCE: ISO/IEC 38500:2024, 3.3]
Governance Framework
-strategies, policies, decision-making structures and accountabilities through which the organization's [=Governance=] arrangements operate
+strategies, policies, decision-making structures and accountabilities through which the organization's [=Governance=] arrangements operate.
[SOURCE: ISO/IEC FDIS 20151-1]
From d9efc6bdec7ea0303ef611635e000507d15bf1a1 Mon Sep 17 00:00:00 2001
From: Sebastian Steinbuss <23654606+ssteinbuss@users.noreply.github.com>
Date: Thu, 27 Aug 2026 15:27:31 +0200
Subject: [PATCH 4/6] Adding bibliographic reference to 20151-1
Adding bibliographic reference to 20151-1
---
index.html | 8 ++++++++
specifications/common/terminology.md | 10 +++++-----
2 files changed, 13 insertions(+), 5 deletions(-)
diff --git a/index.html b/index.html
index eec3ddc..e50eafe 100644
--- a/index.html
+++ b/index.html
@@ -58,6 +58,14 @@
lint: { "no-unused-dfns": false, "local-refs-exist": true },
format: "markdown",
maxTocLevel: 3,
+ localBiblio: {
+ "iso-20151-1": {
+ title: "ISO/IEC FDIS 20151-1 Cloud computing and distributed platforms — Dataspaces — Part 1: Concepts and characteristics",
+ href: "https://www.iso.org/standard/86589.html",
+ publisher: "ISO/IEC",
+ status: "Final Draft International Standard (FDIS), unpublished",
+ },
+ },
};
Dataspace Protocol Release 2025-1
diff --git a/specifications/common/terminology.md b/specifications/common/terminology.md
index f03eadd..dceb970 100644
--- a/specifications/common/terminology.md
+++ b/specifications/common/terminology.md
@@ -46,7 +46,7 @@ Note 2 to entry: Data can be shared, for example, (i) by allowing access to, or
Note 3 to entry: The way in which data is shared fundamentally influences the available controls and the statements needed in a data sharing agreement.
-[SOURCE: ISO/IEC FDIS 20151-1]
+[SOURCE: [[?iso-20151-1]]]
Dataset
@@ -56,9 +56,9 @@ Data or a technical service that can be shared by a [=Participant=].
[=Environment=] enabling trusted [=Data Sharing=] between participating parties, based on an agreed [=Governance Framework=], along with an agreed set of [=Policies=], semantic models, standardized protocols, processes, and facilitating services.
-[SOURCE: ISO/IEC FDIS 20151-1]
+[SOURCE: [[?iso-20151-1]]]
-Note 1 to entry: This specification covers only protocols to facilitate interoperable [=Dataset=] sharing between entities based on technical services. The overarching concepts and characteristics of Dataspaces are described in ISO/IEC FDIS 20151-1.
+Note 1 to entry: This specification covers only protocols to facilitate interoperable [=Dataset=] sharing between entities based on technical services. The overarching concepts and characteristics of Dataspaces are described in [ISO/IEC FDIS 20151-1](#bib-iso-20151-1).
Dataspace Protocol
@@ -72,7 +72,7 @@ A set of rules and conventions that dictate how data is transmitted over a netwo
context determining the setting and circumstances of all influences upon a system.
-[SOURCE: ISO/IEC FDIS 20151-1]
+[SOURCE: [[?iso-20151-1]]]
Governance
@@ -84,7 +84,7 @@ human-based system comprising directing, overseeing and accountability.
strategies, policies, decision-making structures and accountabilities through which the organization's [=Governance=] arrangements operate.
-[SOURCE: ISO/IEC FDIS 20151-1]
+[SOURCE: [[?iso-20151-1]]]
Message Type
From 342834d99ea69f017be443346b8bae67d05b2a56 Mon Sep 17 00:00:00 2001
From: Sebastian Steinbuss <23654606+ssteinbuss@users.noreply.github.com>
Date: Thu, 27 Aug 2026 15:28:10 +0200
Subject: [PATCH 5/6] Update index.html
Update copyright year
---
index.html | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/index.html b/index.html
index e50eafe..3596411 100644
--- a/index.html
+++ b/index.html
@@ -74,7 +74,7 @@
This document is licensed under The Apache License, Version 2.0.
- Copyright © 2025 The Eclipse Foundation AISBL
+ Copyright © 2026 The Eclipse Foundation AISBL
Dataspace Protocol 2025-1
From 96ae3cd5cbc812149a22a147bd0ef4d2980832fe Mon Sep 17 00:00:00 2001
From: Sebastian Steinbuss <23654606+ssteinbuss@users.noreply.github.com>
Date: Fri, 28 Aug 2026 15:16:16 +0200
Subject: [PATCH 6/6] Harmonizing bib links
---
index.html | 12 ++++++++++++
specifications/common/introduction.md | 2 +-
specifications/common/terminology.md | 2 +-
3 files changed, 14 insertions(+), 2 deletions(-)
diff --git a/index.html b/index.html
index 3596411..7dbc03e 100644
--- a/index.html
+++ b/index.html
@@ -65,6 +65,18 @@
publisher: "ISO/IEC",
status: "Final Draft International Standard (FDIS), unpublished",
},
+ "iso-38500-2024": {
+ title: "ISO/IEC 38500:2024 Information technology — Governance of IT for the organization",
+ href: "https://www.iso.org/standard/81684.html",
+ publisher: "ISO/IEC",
+ date: "February 2024",
+ },
+ "iso-7498-1-1994": {
+ title: "ISO/IEC 7498-1:1994 Information technology — Open Systems Interconnection — Basic Reference Model: The Basic Model",
+ href: "https://www.iso.org/standard/20269.html",
+ publisher: "ISO/IEC",
+ date: "November 1994",
+ },
},
};
diff --git a/specifications/common/introduction.md b/specifications/common/introduction.md
index d666007..b35993f 100644
--- a/specifications/common/introduction.md
+++ b/specifications/common/introduction.md
@@ -2,7 +2,7 @@
The __Dataspace Protocol__ is used in the context of [=Dataspaces=] as described and defined in the subsequent sections with the purpose to support _interoperability_. In this context, the specification provides fundamental technical interoperability for [=Participants=] in [=Dataspaces=].
-This specification builds on protocols located in the [ISO OSI model (ISO/IEC 7498-1:1994)](https://www.iso.org/standard/20269.html) layers, like the Hypertext Transfer Protocol (HTTP). The purpose of this specification is to define interactions between systems independent of such protocols, but describing how to implement it in an unambiguous and extensible way. To do so, the messages that are exchanged during the process are described in this specification and the states and their transitions are specified as state machines, based on the key terms and concepts of a [=Dataspace=]. On this foundation the bindings to [=Data Transfer Protocols=], like Hypertext Transfer Protocol Secure (HTTPS), are described.
+This specification builds on protocols located in the ISO Open Systems Interconnection (OSI) model [[?iso-7498-1-1994]] layers, like the Hypertext Transfer Protocol (HTTP). The purpose of this specification is to define interactions between systems independent of such protocols, but describing how to implement it in an unambiguous and extensible way. To do so, the messages that are exchanged during the process are described in this specification and the states and their transitions are specified as state machines, based on the key terms and concepts of a [=Dataspace=]. On this foundation the bindings to [=Data Transfer Protocols=], like Hypertext Transfer Protocol Secure (HTTPS), are described.
_Note: This specification does not cover the data transfer as such. While this is controlled by the [=Transfer Process Protocol=], e.g., the initiation of the transfer channels or their decomissioning, the data transfer itself and especially the handling of technical exceptions is an obligation to the transport protocol._
diff --git a/specifications/common/terminology.md b/specifications/common/terminology.md
index dceb970..32c483c 100644
--- a/specifications/common/terminology.md
+++ b/specifications/common/terminology.md
@@ -78,7 +78,7 @@ context determining the setting and circumstances of all influences upon a syste
human-based system comprising directing, overseeing and accountability.
-[SOURCE: ISO/IEC 38500:2024, 3.3]
+[SOURCE: [[?iso-38500-2024]]]
Governance Framework