Skip to content

Commit afd5084

Browse files
authored
chore: removing the message definition (#233)
removing the message definition * removing the message definition * removing the reference to the message definition * changing some message type mentions to the message type definition
1 parent c7befeb commit afd5084

File tree

5 files changed

+13
-17
lines changed

5 files changed

+13
-17
lines changed

specifications/catalog/catalog.protocol.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
## Introduction
44

55
The [=Catalog Protocol=] defines how a [=Catalog=] is requested from a [=Catalog Service=] by a [=Consumer=] using an
6-
abstract [=Message=] exchange format. The concrete [=Message=] exchange wire format is defined in the binding.
6+
abstract Message exchange format. The concrete Message exchange wire format is defined in the binding.
77

88
The [=Catalog Protocol=] reuses properties from the DCAT and ODRL vocabularies with restrictions defined in this
99
specification. This is done implicitly by the use of the JSON schemas and JSON-LD-contexts that are part of the [=Dataspace Protocol=].

specifications/common/common.protocol.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,9 +9,9 @@ does not require authorization.
99
## Schemas & Contexts
1010

1111
All protocol [=Messages=] are normatively defined by a [[json-schema]]. This specification also uses JSON-LD 1.1 and
12-
provides a JSON-LD context to serialize data structures and [=Message=] types as it facilitates extensibility. The
13-
JSON-LD context is designed to produce [=Message=] serializations using compaction that validate against the JSON Schema
14-
for the given [=Message=] type. This allows implementations to choose whether to process [=Messages=] as plain JSON or
12+
provides a JSON-LD context to serialize data structures and [=Message types=] as it facilitates extensibility. The
13+
JSON-LD context is designed to produce Message serializations using compaction that validate against the JSON Schema
14+
for the given [=Message type=]. This allows implementations to choose whether to process [=Messages=] as plain JSON or
1515
as JSON-LD and maintain interoperability between those approaches. Profiles that use JSON-LD are encouraged to provide
1616
similar contexts that facilitate this approach to interoperability. As this specification's JSON-LD objects are
1717
`@protected`, [=Profile=] authors are advised to define their custom terms as protected to spot term redefinition early.

specifications/common/terminology.md

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -48,19 +48,15 @@ Note 1 to entry: This specification convers only protocols to facilitate interop
4848

4949
<dfn>Dataspace Protocol</dfn>
5050

51-
A set of [=Messages=] and [=Message=] sequences that enables the interaction between [=Participant Agents=] in a [=Dataspace=]. This MAY require additional concepts, which are not in the scope of the specification itself.
51+
A set of Messages and Message sequences that enables the interaction between [=Participant Agents=] in a [=Dataspace=]. This may require additional concepts, which are not in the scope of the specification itself.
5252

5353
<dfn>Data Transfer Protocol</dfn>
5454

5555
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.
5656

57-
<dfn>Message</dfn>
58-
59-
An instantiation of a [=Message Type=].
60-
6157
<dfn>Message Type</dfn>
6258

63-
A definition of the structure of a [=Message=].
59+
A definition of the structure of a Message.
6460

6561
<dfn>Offer</dfn>
6662

specifications/negotiation/contract.negotiation.protocol.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ A [=Contract Negotiation=] involves two parties, a [=Provider=] that offers one
66
and a [=Consumer=] that requests [=Datasets=]. A [=Contract Negotiation=] is uniquely identified through an Internationalized Resource Identifier (IRI) [[rfc3987]]. Each [=Contract Negotiation=]
77
requires a newly generated IRI, which MAY not be used in a [=Contract Negotiation=] after a terminal state has been reached. A [=Contract Negotiation=] progresses
88
through a series of states, which are tracked by the [=Provider=] and [=Consumer=] using [=Messages=]. A [=Contract Negotiation=] transitions to a
9-
state in response to an acknowledged [=Message=] from the counter-party. Both parties have the same state of the [=Contract Negotiation=]. In case
9+
state in response to an acknowledged Message from the counter-party. Both parties have the same state of the [=Contract Negotiation=]. In case
1010
the states differ, the [=Contract Negotiation=] MUST be terminated and a new [=Contract Negotiation=] MAY be initiated.
1111

1212
### States {#contract-negotiation-states}
@@ -21,9 +21,9 @@ The [=Contract Negotiation=] states are:
2121
the [=Consumer=] has sent an ACK response.
2222
- **VERIFIED**: The [=Consumer=] has sent an [=Agreement=] verification to the [=Provider=] and the [=Provider=] has
2323
sent an ACK response.
24-
- **FINALIZED**: The [=Provider=] has sent a finalization [=Message=] including his own [=Agreement=] verification to
24+
- **FINALIZED**: The [=Provider=] has sent a finalization Message including his own [=Agreement=] verification to
2525
the [=Consumer=] and the [=Consumer=] has sent an ACK response. Data is now available to the [=Consumer=].
26-
- **TERMINATED**: The [=Provider=] or [=Consumer=] has placed the [=Contract Negotiation=] in a terminated state. A termination [=Message=] has
26+
- **TERMINATED**: The [=Provider=] or [=Consumer=] has placed the [=Contract Negotiation=] in a terminated state. A termination Message has
2727
been sent by either of the [=Participants=] and the other has sent an ACK response. This is a terminal state.
2828

2929
### State Machine
@@ -32,12 +32,12 @@ The [=Contract Negotiation=] state machine is represented in the following diagr
3232

3333
!["Contract Negotiation State Machine"](figures/contract.negotiation.state.machine.png "Contract Negotiation State Machine")
3434

35-
Transitions marked with `C` indicate a [=Message=] sent by the [=Consumer=], transitions marked with `P` indicate
36-
a [=Provider=] [=Message=]. Terminal states are final; the state machine MUST NOT transition to another state. A new [=Contract Negotiation=] MAY be initiated if, for instance, the [=Contract Negotiation=] entered the `TERMINATED` state due to a network issue.
35+
Transitions marked with `C` indicate a Message sent by the [=Consumer=], transitions marked with `P` indicate
36+
a [=Provider=] Message. Terminal states are final; the state machine MUST NOT transition to another state. A new [=Contract Negotiation=] MAY be initiated if, for instance, the [=Contract Negotiation=] entered the `TERMINATED` state due to a network issue.
3737

3838
## Message Types
3939

40-
The [=Contract Negotiation=] state machine is transitioned upon receipt and acknowledgement of a [=Message=]. This section details those [=Messages=] as abstract [=Message Types=].
40+
The [=Contract Negotiation=] state machine is transitioned upon receipt and acknowledgement of a Message. This section details those [=Messages=] as abstract [=Message Types=].
4141

4242
- Concrete wire formats are defined by the protocol binding,
4343
e.g., [Contract Negotiation HTTPS Binding](#contract-negotiation-https-binding).

specifications/transfer/transfer.process.protocol.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
A [=Transfer Process=] involves two parties, a [=Provider=] that offers one or more [=Datasets=] along with
66
a [=Policy=] and a [=Consumer=] that requests [=Datasets=]. A [=Transfer Process=] progresses through a series of states, which are
77
controlled by the [=Provider=] and [=Consumer=] using [=Messages=]. A [=Transfer Process=] transitions to another state as a result of an
8-
exchanged [=Message=].
8+
exchanged Message.
99

1010
### Prerequisites
1111

0 commit comments

Comments
 (0)