From 6df202c18dc4e6170b8556bc59fd76337a035f38 Mon Sep 17 00:00:00 2001 From: Paul Latzelsperger Date: Wed, 25 Mar 2026 14:52:29 +0100 Subject: [PATCH 1/2] docs: decision record about introducing Dataspace Hub --- .../2026-03-25-dataspace-hub/README.md | 40 +++++++++++++++++++ developer/decision-records/README.md | 1 + 2 files changed, 41 insertions(+) create mode 100644 developer/decision-records/2026-03-25-dataspace-hub/README.md diff --git a/developer/decision-records/2026-03-25-dataspace-hub/README.md b/developer/decision-records/2026-03-25-dataspace-hub/README.md new file mode 100644 index 0000000..4a5e9cb --- /dev/null +++ b/developer/decision-records/2026-03-25-dataspace-hub/README.md @@ -0,0 +1,40 @@ +# Moving Samples and documentation to a new "Dataspace Hub" project + +## Decision + +A new project tentatively titled "Eclipse Dataspace Hub" will be created with the purpose of housing documentation and sample code. This includes EDC's documentation and samples, but also that of other projects such as `eclipse-cfm` and `eclipse-dataplane-core` and potentially others. + +## Rationale + +Moving documentation and sample code to a dedicated space has several advantages: + +- discoverability: Dataspace Hub can serve as single port-of-entry for developers new to the dataspace world. No need to go hunting in multiple projects, orgs or repos for information. +- dependencies: code in the Dataspace Hub project will only have upstream dependencies, e.g. onto EDC, the dataplane SDKs etc. +- focused community: the barrier of entry for developers interested in becoming contributors is lower. At the same time it is a more digestible way to get familiar with the code base. + +## Approach + +### (Re-)move samples + +All samples, that are focused on data transfers will have to be adapted to reflect the use of Dataplane SDKs or the "Siglet". Samples should show how to implement a dataplane rather than "how to use transmission technology X". They become showcases of the SDKs or the Siglet rather than a specific wire protocol. + +Other samples (`basic/` and `advanced/`) can remain and need only be moved. + +### Adapt MVD and JAD + +In addition to specific small samples we will continue to offer larger end-to-end samples, specifically: + +- MVD: showcases a dataspace using the "classic" (single-tenant) configuration of EDC with only extremely rudimentary data transfer capabilities. +- JAD: showcases a dataspace using the "virtualized" (multi-tenant) configuration of EDC including the Connector Fabric Manager (CFM), an API facade ("redline") and possibly even a web UI. + +MVD will need to be refactored in the following aspects: + +- remove Terraform/OpenTofu, use plain Kubernetes manifests instead +- align naming with JAD +- remove IntelliJ deployment: while this has proven to be useful in the past, it increases maintenance churn, complicates the sample and can almost entirely be replaced with in-cluster debugging. + +### Consolidate documentation + +The EDC documentation should get merged with other documentation repositories to become the "Dataspace Hub Documentation" that includes CFM, the dataplane signaling SDKs, etc. + +_Note: the term "Dataspace Hub is a working title and is open for discussion_ diff --git a/developer/decision-records/README.md b/developer/decision-records/README.md index 7c2ed96..eb23ef3 100644 --- a/developer/decision-records/README.md +++ b/developer/decision-records/README.md @@ -32,6 +32,7 @@ - [2024-10-11 Dependencies Check](./2024-10-11-dependencies-check/) - [2026-02-25 On the usage of Artificial Intelligence](./2026-02-25-using-ai/) - [2026-03-22 Catalog Crawler as Control-Plane feature](./2026-03-02-catalog-crawler/) +- [2026-02-25 Introducing Dataspace Hub](./2026-03-25-dataspace-hub/) ## Repository-specific From 8afb69801db1da6a9bbf89eed8091cee90f42054 Mon Sep 17 00:00:00 2001 From: Paul Latzelsperger Date: Wed, 25 Mar 2026 15:06:02 +0100 Subject: [PATCH 2/2] update DR --- developer/decision-records/2026-03-25-dataspace-hub/README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/developer/decision-records/2026-03-25-dataspace-hub/README.md b/developer/decision-records/2026-03-25-dataspace-hub/README.md index 4a5e9cb..db2fbe0 100644 --- a/developer/decision-records/2026-03-25-dataspace-hub/README.md +++ b/developer/decision-records/2026-03-25-dataspace-hub/README.md @@ -30,6 +30,7 @@ In addition to specific small samples we will continue to offer larger end-to-en MVD will need to be refactored in the following aspects: - remove Terraform/OpenTofu, use plain Kubernetes manifests instead +- simplify participants: only one provider and one consumer, remove management domains - align naming with JAD - remove IntelliJ deployment: while this has proven to be useful in the past, it increases maintenance churn, complicates the sample and can almost entirely be replaced with in-cluster debugging.