Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions .github/workflows/pr.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
name: PR checks
on:
pull_request:
branches: [ main ]
permissions:
contents: read
jobs:
quality:
uses: International-Data-Spaces-Association/.github/.github/workflows/reusable-pr-quality.yml@main
with:
content_dir: ${{ vars.CONTENT_DIR }}
13 changes: 13 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
name: Release export
on:
release:
types: [ published ]
permissions:
contents: write
jobs:
export:
uses: International-Data-Spaces-Association/.github/.github/workflows/reusable-release-export.yml@main
with:
content_dir: ${{ vars.CONTENT_DIR }}
summary_path: ${{ vars.SUMMARY_PATH }}
output_basename: ${{ github.event.repository.name }}
28 changes: 17 additions & 11 deletions docs/glossary.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,16 @@
# IDSA Glossary

This draft document is created to ensure consistent terminology across IDSA's documents.
The definitions are aligned with the ISO DIS 20151 (to be published at the time of writing this document) and the Dataspace Protocol (2025-1 release) where possible.
The definitions are aligned with the ISO DIS 20151 (to be published at the time of writing this document) and the Dataspace Protocol (2025-1 release) where possible.

Check failure on line 4 in docs/glossary.md

View workflow job for this annotation

GitHub Actions / quality / markdown_lint

Line length

docs/glossary.md:4:81 MD013/line-length Line length [Expected: 80; Actual: 165] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md013.md

Check warning on line 4 in docs/glossary.md

View workflow job for this annotation

GitHub Actions / quality / spell_check

Unknown word (Dataspace)
Additional notes are provided where different terms are used for the same concept across the two sources.

Check failure on line 5 in docs/glossary.md

View workflow job for this annotation

GitHub Actions / quality / markdown_lint

Line length

docs/glossary.md:5:81 MD013/line-length Line length [Expected: 80; Actual: 105] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md013.md
Please note this is just an initial draft to provide a starting point. The structure and approach could be updated in the next steps.

Check failure on line 6 in docs/glossary.md

View workflow job for this annotation

GitHub Actions / quality / markdown_lint

Line length

docs/glossary.md:6:81 MD013/line-length Line length [Expected: 80; Actual: 133] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md013.md

## A

### Agreement

A concrete [Policy](#policy) associated with a specific [Dataset](#dataset) that has been agreed between the [Provider](#provider) and [Consumer](#consumer). It is a result of a [Contract Negotiation](#contract-negotiation) defining the [Policy](#policy) agreed to for a [Dataset](#dataset).

Check failure on line 12 in docs/glossary.md

View workflow job for this annotation

GitHub Actions / quality / markdown_lint

Line length

docs/glossary.md:12:81 MD013/line-length Line length [Expected: 80; Actual: 291] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md013.md
Please also see [data sharing contract]
Please also see [data sharing contract]

(Source: ISO/IEC DIS 20151)

Expand All @@ -19,19 +20,19 @@

A collection of entries representing [Offers](#offer) that are advertised by a [Provider](#provider).

(Source: Dataspace Protocol)

Check warning on line 23 in docs/glossary.md

View workflow job for this annotation

GitHub Actions / quality / spell_check

Unknown word (Dataspace)

### Catalog Protocol

A set of allowable [Message Types](#message-type) that are used to request a [Catalog](#catalog) from a [Catalog Service](#catalog-service).

Check failure on line 27 in docs/glossary.md

View workflow job for this annotation

GitHub Actions / quality / markdown_lint

Line length

docs/glossary.md:27:81 MD013/line-length Line length [Expected: 80; Actual: 140] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md013.md

### Catalog Service

A [Participant Agent](#participant-agent) that makes a [Catalog](#catalog) available and accessible to [Participants](#participant).

Check failure on line 31 in docs/glossary.md

View workflow job for this annotation

GitHub Actions / quality / markdown_lint

Line length

docs/glossary.md:31:81 MD013/line-length Line length [Expected: 80; Actual: 132] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md013.md

### Connector (Data Service)

A [Participant Agent](#participant-agent) that performs [Contract Negotiation](#contract-negotiation) and [Transfer Process](#transfer-process) operations with other [Connectors](#data-service), by implementing [Dataspace Protocols](#dataspace-protocol). It produces [Agreements](#agreement) and manages [Dataset](#dataset) sharing.
A [Participant Agent](#participant-agent) that performs [Contract Negotiation](#contract-negotiation) and [Transfer Process](#transfer-process) operations with other Connectors, by implementing [Dataspace Protocols](#dataspace-protocol). It produces [Agreements](#agreement) and manages [Dataset](#dataset) sharing.

Check failure on line 35 in docs/glossary.md

View workflow job for this annotation

GitHub Actions / quality / markdown_lint

Line length

docs/glossary.md:35:81 MD013/line-length Line length [Expected: 80; Actual: 315] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md013.md

Check warning on line 35 in docs/glossary.md

View workflow job for this annotation

GitHub Actions / quality / spell_check

Unknown word (Dataspace)

### Consumer

Expand All @@ -39,7 +40,7 @@

### Contract Negotiation

A set of interactions between a [Provider](#provider) and [Consumer](#consumer) that establish an [Agreement](#agreement). It is an instantiation of the state machine of a [Contract Negotiation Protocol](#contract-negotiation-protocol). An outcome of a Contract Negotiation MAY be the production of an [Agreement](#agreement).

Check failure on line 43 in docs/glossary.md

View workflow job for this annotation

GitHub Actions / quality / markdown_lint

Line length

docs/glossary.md:43:81 MD013/line-length Line length [Expected: 80; Actual: 326] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md013.md

### Contract Negotiation Protocol

Expand All @@ -51,24 +52,27 @@

Data or a technical service that can be shared by a [Participant](#participant).

### dataspace

Check warning on line 55 in docs/glossary.md

View workflow job for this annotation

GitHub Actions / quality / spell_check

Unknown word (dataspace)
_data space_

#### _data space_

[governance framework](#governance-framework) and supporting services to build [trustworthiness](#trustworthiness) and enable [data sharing](#data-sharing) through an agreed set of [Policies](#policy), semantic models, protocols and processes

Check failure on line 59 in docs/glossary.md

View workflow job for this annotation

GitHub Actions / quality / markdown_lint

Line length

docs/glossary.md:59:81 MD013/line-length Line length [Expected: 80; Actual: 242] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md013.md

[SOURCE: ISO/IEC DIS 20151]

### dataspace governance authority role

Check warning on line 63 in docs/glossary.md

View workflow job for this annotation

GitHub Actions / quality / spell_check

Unknown word (dataspace)
_DSGA role_

#### _DSGA role_

Check warning on line 65 in docs/glossary.md

View workflow job for this annotation

GitHub Actions / quality / spell_check

Unknown word (DSGA)

set of activities provided by one or more parties that establishes, governs, manages and enforces the technical policies and business rules of a [dataspace](#dataspace)

Check failure on line 67 in docs/glossary.md

View workflow job for this annotation

GitHub Actions / quality / markdown_lint

Line length

docs/glossary.md:67:81 MD013/line-length Line length [Expected: 80; Actual: 168] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md013.md

Check warning on line 67 in docs/glossary.md

View workflow job for this annotation

GitHub Actions / quality / spell_check

Unknown word (dataspace)

[SOURCE: ISO/IEC 20151 to be published]

### dataspace participant

Check warning on line 71 in docs/glossary.md

View workflow job for this annotation

GitHub Actions / quality / spell_check

Unknown word (dataspace)
_participant_

#### _participant_

party that is acting in a [dataspace participant role](#dataspace-participant-role)

Check warning on line 75 in docs/glossary.md

View workflow job for this annotation

GitHub Actions / quality / spell_check

Unknown word (dataspace)

Note 1 to entry: By being accepted to be a participant in the dataspace, the party agrees to the governance arrangements and therefore the policies of the dataspace.
[SOURCE: ISO/IEC 20151 to be published]
Expand All @@ -76,7 +80,8 @@
Please also see [Participant](#participant) definition sourced from DSP.

### dataspace participant role
_participant role_

#### _participant role_

set of activities within a [dataspace](#dataspace) for the purpose of [data sharing](#data-sharing) or related activities
Note 1 to entry: Related activities can include auditing or observing roles that do not include data sharing or governance activities.
Expand All @@ -87,8 +92,9 @@
human and machine-readable set of rights and obligations regarding access and use of data
[SOURCE: ISO/IEC 20151 to be published]

### Dataspace Protocol

Check warning on line 95 in docs/glossary.md

View workflow job for this annotation

GitHub Actions / quality / spell_check

Unknown word (Dataspace)

A set of Messages and Message sequences that enables the interaction between [Participant Agents](#participant-agent) in a [dataspace](#dataspace). This may require additional concepts, which are not in the scope of the specification itself.
A set of Messages and Message sequences that enables the interaction between [Participant Agents](#participant-agent) in a [Dataspace](#dataspace). This may require additional concepts, which are not in the scope of the specification itself.

### Data Transfer Protocol
Expand All @@ -109,14 +115,14 @@

### data sharing contract

formal and legally binding agreement between [dataspace participants](#dataspace-participants) containing policies, terms and
formal and legally binding agreement between [dataspace participants](#dataspace-participant) containing policies, terms and
conditions for [data sharing](#data-sharing)
Note 1 to entry: Data sharing contracts usually contain information about access to data, including its metadata, and
data use.
Note 2 to entry: A data sharing contract is usually much more specific than a data sharing agreement which is often broader and often at an organizational level.
[SOURCE: ISO/IEC 20151 to be published]

Please also see [Agreement](#Agreement) for a related definition sourced from DSP.
Please also see [Agreement](#agreement) for a related definition sourced from DSP.

### data use

Expand Down Expand Up @@ -159,7 +165,7 @@

### Participant Agent

A technology system that performs operations and interactions in a [Dataspace](#dataspace) on behalf of a [Participant](#participant), such as publishing a [Catalog](#catalog) or engaging in a [Transfer Process](#transfer-process). It is a logical construct and does not necessarily correspond to a single runtime process. While most interactions take place between so-called [Connectors](#data-service), some interactions with other systems are required.
A technology system that performs operations and interactions in a [Dataspace](#dataspace) on behalf of a [Participant](#participant), such as publishing a [Catalog](#catalog) or engaging in a [Transfer Process](#transfer-process). It is a logical construct and does not necessarily correspond to a single runtime process. While most interactions take place between so-called Connectors, some interactions with other systems are required.

### Policy

Expand Down Expand Up @@ -193,4 +199,4 @@

set of verifiable evidence that can be used to form [trust](#trust)

[SOURCE: ISO/IEC 20151 to be published]
[SOURCE: ISO/IEC 20151 to be published]
Loading