From 5257c910c416cd69d2a5ceb5e8c519ffe1ad1ee9 Mon Sep 17 00:00:00 2001 From: Pierre-Antoine Champin Date: Thu, 27 Feb 2025 22:04:25 +0100 Subject: [PATCH 1/5] address #630 I'm not entirely satisfied with the addition in common/terms.html, as it seems too detailed for the terminology section. But... ...as pointed out in the comment of #630, the API spec references to this definition in multiple places, and many of those links are actually for instances of the internal representation, *not* for instances of the strings or maps that represent term definition in JSON. So the alternative would be to introduce a new name for those "internal term definition" and patch all the algorithms... which seems laborious and error-prone. @gkellogg I don't remember what's the process for synchronizing the files in common with other specs. --- common/terms.html | 3 ++- index.html | 4 ++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/common/terms.html b/common/terms.html index 9660e67e..208dedf1 100644 --- a/common/terms.html +++ b/common/terms.html @@ -382,7 +382,8 @@ as a key, type, or elsewhere that a string is interpreted as a vocabulary item. Its value is either a string (simple term definition), expanding to an IRI, - or a map (expanded term definition). + or a map (expanded term definition).
+ For context processing, term definitions' values are converted internally to a dedicated data structure that is easier to process.
type map
A type map is a map value of a term diff --git a/index.html b/index.html index a440f6ef..d025c9d2 100644 --- a/index.html +++ b/index.html @@ -1074,7 +1074,7 @@

RDF Serialization/Deserialization

The active context consists of:

-

Each term definition consists of:

+

Each term definition's value consists of:

type map
A type map is a map value of a term diff --git a/index.html b/index.html index d025c9d2..4fe15027 100644 --- a/index.html +++ b/index.html @@ -1074,7 +1074,7 @@

RDF Serialization/Deserialization

The active context consists of:

-

Each term definition's value consists of:

+

Each term definition's value consists of:

type map
A type map is a map value of a term From 913511d4b06d99b30d803e931b2d52f4dbf730ec Mon Sep 17 00:00:00 2001 From: Pierre-Antoine Champin Date: Fri, 28 Feb 2025 09:47:30 +0100 Subject: [PATCH 4/5] turn into a candidate addition I didn't follow the pattern 'change_N' for the id, because this change will also be present in json-ld-syntax (in comment/terms), and so will probably require a candidate addition in that spec too (with a different index). Hence the more robust id used here. --- common/terms.html | 5 +++-- index.html | 15 +++++++++++++-- 2 files changed, 16 insertions(+), 4 deletions(-) diff --git a/common/terms.html b/common/terms.html index b8233616..a779d5ed 100644 --- a/common/terms.html +++ b/common/terms.html @@ -382,8 +382,9 @@ as a key, type, or elsewhere that a string is interpreted as a vocabulary item. Its value is either a string (simple term definition), expanding to an IRI, - or a map (expanded term definition).
- For context processing, term definition values are converted internally to a dedicated data structure that is easier to process. + or a map (expanded term definition). +
+ For context processing, term definition values are converted internally to a dedicated data structure that is easier to process.
type map
A type map is a map value of a term diff --git a/index.html b/index.html index 4fe15027..d38f2558 100644 --- a/index.html +++ b/index.html @@ -1071,10 +1071,19 @@

RDF Serialization/Deserialization

using information provided by the active context. This section describes how to produce an active context.

+
+ Candidate Correction 8 +

Change the type of term definition from array to map in active context, + to be consistent with the way it is used in the algorithms. + Clarify the notion term definition. + For more information, refer to issue 630. +

+
+

The active context consists of:

-

Each term definition's value consists of:

+

Each term definition's value consists of:

From b03780267de7f463f12e5bacadbedeb0150ce5e2 Mon Sep 17 00:00:00 2001 From: Pierre-Antoine Champin Date: Wed, 12 Mar 2025 18:34:49 +0100 Subject: [PATCH 5/5] Update index.html Co-authored-by: Ted Thibodeau Jr --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index d38f2558..97d87df9 100644 --- a/index.html +++ b/index.html @@ -1075,7 +1075,7 @@

RDF Serialization/Deserialization

Candidate Correction 8

Change the type of term definition from array to map in active context, to be consistent with the way it is used in the algorithms. - Clarify the notion term definition. + Clarify the notion of "term definition". For more information, refer to issue 630.