From c0b1d514b08b777013dfa52009ffb64b64791368 Mon Sep 17 00:00:00 2001 From: Michael McCool Date: Mon, 4 Jul 2022 12:57:43 -0300 Subject: [PATCH 01/12] update Farshid's affiliation --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index b68febe1..f4fac422 100644 --- a/index.html +++ b/index.html @@ -43,7 +43,7 @@ }, { name : "Farshid Tavakolizadeh", w3cid : "122520", - company : "Fraunhofer-Gesellschaft", + company : "formerly Fraunhofer-Gesellschaft, currently Invited Expert", companyURL : "https://www.fraunhofer.de/" }, { name : "Kunihiko Toumura", From d1774b56c827ff9cd866457f691ff6f1fb7e3e07 Mon Sep 17 00:00:00 2001 From: Michael McCool Date: Mon, 4 Jul 2022 13:01:48 -0300 Subject: [PATCH 02/12] remove issue 48 --- index.html | 3 --- publication/3-wd/index.html | 5 +---- 2 files changed, 1 insertion(+), 7 deletions(-) diff --git a/index.html b/index.html index f4fac422..35d21181 100644 --- a/index.html +++ b/index.html @@ -1577,9 +1577,6 @@

Creation

In particular, if `ttl` (relative expiry) is given during the creation, such servers will calculate and store the `expires` value.

- -

-

diff --git a/publication/3-wd/index.html b/publication/3-wd/index.html index 73d8b2b9..5efa2783 100644 --- a/publication/3-wd/index.html +++ b/publication/3-wd/index.html @@ -47,7 +47,7 @@ }, { name : "Farshid Tavakolizadeh", w3cid : "122520", - company : "Fraunhofer-Gesellschaft", + company : "formerly Fraunhofer-Gesellschaft, currently Invited Expert", companyURL : "https://www.fraunhofer.de/" }, { name : "Kunihiko Toumura", @@ -1577,9 +1577,6 @@

Creation

In particular, if `ttl` (relative expiry) is given during the creation, such servers will calculate and store the `expires` value.

- -

-

From d1e28c61870c8fb4d8672a566281450816b4b63b Mon Sep 17 00:00:00 2001 From: Michael McCool Date: Mon, 4 Jul 2022 13:04:54 -0300 Subject: [PATCH 03/12] defer issue 150 --- index.html | 4 ++++ publication/3-wd/index.html | 4 ++++ 2 files changed, 8 insertions(+) diff --git a/index.html b/index.html index 35d21181..326c79d6 100644 --- a/index.html +++ b/index.html @@ -1356,11 +1356,13 @@

Directory Service API

set in the HTTP request [[RFC7231]].

+

The APIs set the HTTP status codes as defined in @@ -2084,10 +2086,12 @@

Validation

] } + diff --git a/publication/3-wd/index.html b/publication/3-wd/index.html index 5efa2783..a766a5a9 100644 --- a/publication/3-wd/index.html +++ b/publication/3-wd/index.html @@ -1356,11 +1356,13 @@

Directory Service API

set in the HTTP request [[RFC7231]].

+

The APIs set the HTTP status codes as defined in @@ -2086,10 +2088,12 @@

Validation

] } + From b8ed2c292e8e238d480b9fa912ec0cc003498bcf Mon Sep 17 00:00:00 2001 From: Michael McCool Date: Mon, 4 Jul 2022 13:06:10 -0300 Subject: [PATCH 04/12] defer issue 176 --- index.html | 3 ++- publication/3-wd/index.html | 2 ++ 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/index.html b/index.html index 326c79d6..42f2484d 100644 --- a/index.html +++ b/index.html @@ -2166,10 +2166,11 @@

Events API

get multiplexed on a single connection.

- +
Event Data
diff --git a/publication/3-wd/index.html b/publication/3-wd/index.html index a766a5a9..1a317aa4 100644 --- a/publication/3-wd/index.html +++ b/publication/3-wd/index.html @@ -2171,9 +2171,11 @@

Events API

+
Event Data

From f93c336d504fb1b5b7e169b81711acd705625214 Mon Sep 17 00:00:00 2001 From: Michael McCool Date: Mon, 4 Jul 2022 13:07:25 -0300 Subject: [PATCH 05/12] defer issue 234 --- index.html | 2 ++ publication/3-wd/index.html | 2 ++ 2 files changed, 4 insertions(+) diff --git a/index.html b/index.html index 42f2484d..f5f998ec 100644 --- a/index.html +++ b/index.html @@ -2325,6 +2325,7 @@

Search API

Syntactic search: JSONPath

+ Support for JSONPath Search API is optional. If implemented, the JSONPath API must allow searching TDs using an HTTP GET request at `/search/jsonpath?query={query}` endpoint, where `query` is the JSONPath expression. diff --git a/publication/3-wd/index.html b/publication/3-wd/index.html index 1a317aa4..ee17b8a0 100644 --- a/publication/3-wd/index.html +++ b/publication/3-wd/index.html @@ -2332,6 +2332,7 @@

Search API

Syntactic search: JSONPath

+ Support for JSONPath Search API is optional. If implemented, the JSONPath API must allow searching TDs using an HTTP GET request at `/search/jsonpath?query={query}` endpoint, where `query` is the JSONPath expression. From 76d54bdba1bbb0356cdf796a17b66d11c2d6ddbe Mon Sep 17 00:00:00 2001 From: Michael McCool Date: Mon, 4 Jul 2022 13:10:49 -0300 Subject: [PATCH 06/12] defer issue 82 --- index.html | 2 ++ publication/3-wd/index.html | 2 ++ 2 files changed, 4 insertions(+) diff --git a/index.html b/index.html index f5f998ec..6ec8f909 100644 --- a/index.html +++ b/index.html @@ -2409,10 +2409,12 @@

API Specification (Thing Model)

+

The context URIs are tentative and subject to change.

diff --git a/publication/3-wd/index.html b/publication/3-wd/index.html index ee17b8a0..80eeccf6 100644 --- a/publication/3-wd/index.html +++ b/publication/3-wd/index.html @@ -2897,10 +2897,12 @@

API Specification (Thing Model)

--> +

The context URIs are tentative and subject to change.

From d786cebee03f322de7cb42e90e0b79ccb9a9cb38 Mon Sep 17 00:00:00 2001 From: Michael McCool Date: Mon, 4 Jul 2022 13:12:48 -0300 Subject: [PATCH 07/12] clean up IANA table --- index.html | 2 +- publication/3-wd/index.html | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/index.html b/index.html index 6ec8f909..ab45bab7 100644 --- a/index.html +++ b/index.html @@ -2946,7 +2946,7 @@

CoRE Resource Types Registration

Link Target Attribute Values sub-registry of the Constrained Restful Environments (CoRE) Parameters registry defined in [[RFC6690]].

- +
diff --git a/publication/3-wd/index.html b/publication/3-wd/index.html index 80eeccf6..b2bd4f86 100644 --- a/publication/3-wd/index.html +++ b/publication/3-wd/index.html @@ -3407,7 +3407,7 @@

CoRE Resource Types Registration

Link Target Attribute Values sub-registry of the Constrained Restful Environments (CoRE) Parameters registry defined in [[RFC6690]].

-
Value
+
From b130630c1c7827fce35a62ae2db4b36ba2f9778e Mon Sep 17 00:00:00 2001 From: Michael McCool Date: Mon, 4 Jul 2022 13:17:21 -0300 Subject: [PATCH 08/12] regen static/tidy versions --- publication/3-wd/Overview.html | 164 ++++----------------------------- publication/3-wd/static.html | 73 +++++---------- 2 files changed, 42 insertions(+), 195 deletions(-) diff --git a/publication/3-wd/Overview.html b/publication/3-wd/Overview.html index de0cb9d0..353a77ab 100644 --- a/publication/3-wd/Overview.html +++ b/publication/3-wd/Overview.html @@ -2,7 +2,7 @@ +"HTML Tidy for HTML5 for Linux version 5.8.0"> - +

W3C Working Draft -

-
+
More details about this document
This version:
https://www.w3.org/TR/2022/WD-wot-discovery-20220627/
+"https://www.w3.org/TR/2022/WD-wot-discovery-20220704/">https://www.w3.org/TR/2022/WD-wot-discovery-20220704/
Latest published version:
https://www.w3.org/TR/wot-discovery/
@@ -1074,8 +1074,8 @@

Web of Things (WoT) Discovery

Corp.)
Farshid Tavakolizadeh (Fraunhofer-Gesellschaft)
+"p-org org h-org" href="https://www.fraunhofer.de/">formerly +Fraunhofer-Gesellschaft, currently Invited Expert)
Kunihiko Toumura (Hitachi, @@ -2963,30 +2963,6 @@

RFC7231].

-
-
Issue 150: -Definition of Problem Details error types Stretch goalDiscuss2021-10 F2F
-

There are currently no WoT-specific error classes. In -the meantime, the Problem Details error responses may omit the -type field which defaults to "about:blank" and set -title to the HTTP status text.

-

The APIs set the HTTP status codes as defined in Section 6 of [7.3.2.1.1 In particular, if ttl (relative expiry) is given during the creation, such servers will calculate and store the expires value.

-
-
Issue 48: How -to avoid duplicates in a directory Propose -Closing
-

Registration of TDs using non-idempotent HTTP POST -method enables creation of anonymous TDs (TDs without id attribute). The producer can distinguish -between the created TDs using the unique-system generated IDs given -in the response Location header.

-

A side-effect of this is that clients will be able to -register duplicate TDs accidentally or on purpose.

-

Need to clarify:

-
    -
  • What are the use cases where a duplicate TD is desired?
    • -
  • How can we mitigate accidental duplicates (deduplication)?
    • -
-
@@ -3310,7 +3263,7 @@
7.3.2.1.2 "hljs-string">"Simple TD" }
-
Issue 148: @@ -3364,7 +3317,7 @@
7.3.2.1.2 "hljs-string">"Anonymous TD" }
-
Issue 148: @@ -3414,7 +3367,7 @@
7.3.2.1.2 "hljs-string">"Expirable TD" }
-
Issue 148: @@ -3873,32 +3826,9 @@
7.3.2.1.6 "hljs-string">"Invalid type. Expected: string, given: integer" } ] -} -
-
Issue 150: -Definition of Problem Details error types Stretch goalDiscuss2021-10 F2F
-

This example skips the type field due to -the current lack of WoT-specific error types.

-
- +}
-
Issue 99: @@ -3975,23 +3905,6 @@
7.3.2.2 thing_deleted) from the server. When using HTTP/2, multiple subscriptions on the same domain (HTTP streams) get multiplexed on a single connection.

-
-
Issue 176: -Event payload filtering Stretch goal2021-10 F2F
-
Event filtering based on the payload is work in -progress.
-

Event Data
@@ -4075,7 +3988,7 @@
7.3.2.2 data: } id: event_1
-
Issue 148: @@ -4208,30 +4121,6 @@

This section is non-normative.

-
-
Issue 234: -JSONPath as a search query language Propose -ClosingConsolidation
-
The standardization of JSONPath expressions is in -progress by an independent working group. This section remains -non-normative until the release of final JSONPath specification by -IETF. In the meantime, clients should consider the JSONPath API as -unstable and expect deviations across Thing Description -Directory implementations.
-
Support for JSONPath Search API is optional. If implemented, the JSONPath API must allow searching TDs using an HTTP GET request at @@ -5215,16 +5104,6 @@
-
-
Issue 82: -Creation of OpenAPI spec from Directory TD
-

Need to confirm if equivalent OpenAPI spec can be -easily created out of the TM. If yes, a sentence may be added -indicating this possibility.

-
Editor's noteRFC6690].

-
Value
+
@@ -5774,7 +5653,7 @@

Directory Description of a Thing Description +"ref-for-dfn-wot-thing-description-directory-25">Thing Description Directory

ValueC.2 title="§ 7.3.1.1 Registration Information">§ 7.3.1.1 Registration Information
  • § 7.3.2.3.1 -Syntactic search: JSONPath
    • -
  • § 11.3 CoRE Resource Types Registration
    • diff --git a/publication/3-wd/static.html b/publication/3-wd/static.html index 3c4b761c..d7baf66d 100644 --- a/publication/3-wd/static.html +++ b/publication/3-wd/static.html @@ -166,7 +166,7 @@ "name": "Web of Things (WoT) Discovery", "inLanguage": "en-US", "license": "https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document", - "datePublished": "2022-06-27", + "datePublished": "2022-07-04", "copyrightHolder": { "name": "World Wide Web Consortium", "url": "https://www.w3.org/" @@ -196,7 +196,7 @@ "type": "Person", "name": "Farshid Tavakolizadeh", "worksFor": { - "name": "Fraunhofer-Gesellschaft", + "name": "formerly Fraunhofer-Gesellschaft, currently Invited Expert", "url": "https://www.fraunhofer.de/" } }, @@ -941,7 +941,7 @@ { "name": "Farshid Tavakolizadeh", "w3cid": "122520", - "company": "Fraunhofer-Gesellschaft", + "company": "formerly Fraunhofer-Gesellschaft, currently Invited Expert", "companyURL": "https://www.fraunhofer.de/" }, { @@ -1022,20 +1022,20 @@ "id": "wot-usecases" } }, - "publishISODate": "2022-06-27T00:00:00.000Z", - "generatedSubtitle": "W3C Working Draft 27 June 2022" + "publishISODate": "2022-07-04T00:00:00.000Z", + "generatedSubtitle": "W3C Working Draft 04 July 2022" } -
    +

    Web of Things (WoT) Discovery

    -

    W3C Working Draft

    +

    W3C Working Draft

    More details about this document
    This version:
    - https://www.w3.org/TR/2022/WD-wot-discovery-20220627/ + https://www.w3.org/TR/2022/WD-wot-discovery-20220704/
    Latest published version:
    https://www.w3.org/TR/wot-discovery/ @@ -1058,7 +1058,7 @@

    Web of Things (WoT) Discovery

    Michael McCool (Intel Corp.)
    - Farshid Tavakolizadeh (Fraunhofer-Gesellschaft) + Farshid Tavakolizadeh (formerly Fraunhofer-Gesellschaft, currently Invited Expert)
    Kunihiko Toumura (Hitachi, Ltd.)
    @@ -2309,11 +2309,7 @@

    Web of Things (WoT) Discovery

    set in the HTTP request [RFC7231].

    -
    Issue 150: Definition of Problem Details error types Stretch goalDiscuss2021-10 F2F

    - There are currently no WoT-specific error classes. In the meantime, - the Problem Details error responses may omit the type field which defaults - to "about:blank" and set title to the HTTP status text. -

    +

    The APIs set the HTTP status codes as defined in @@ -2530,14 +2526,6 @@

    Web of Things (WoT) Discovery

    In particular, if ttl (relative expiry) is given during the creation, such servers will calculate and store the expires value.

    - -
    Issue 48: How to avoid duplicates in a directory Propose Closing

    Registration of TDs using non-idempotent HTTP POST method enables creation of anonymous TDs (TDs without id attribute). The producer can distinguish between the created TDs using the unique-system generated IDs given in the response Location header.

    -

    A side-effect of this is that clients will be able to register duplicate TDs accidentally or on purpose.

    -

    Need to clarify:

    -
      -
    • What are the use cases where a duplicate TD is desired?
      • -
    • How can we mitigate accidental duplicates (deduplication)?
      • -
    7.3.2.1.2 Retrieval
    @@ -2582,7 +2570,7 @@

    Web of Things (WoT) Discovery

    }, "title": "Simple TD" } -
    Issue 148: Discovery context and namespace under w3.org/ns
    +
    Issue 148: Discovery context and namespace under w3.org/ns
    The context URIs are tentative and subject to change.
    @@ -2616,7 +2604,7 @@

    Web of Things (WoT) Discovery

    }, "title": "Anonymous TD" } -
    Issue 148: Discovery context and namespace under w3.org/ns
    +
    Issue 148: Discovery context and namespace under w3.org/ns
    The context URIs are tentative and subject to change.
    @@ -2651,7 +2639,7 @@

    Web of Things (WoT) Discovery

    }, "title": "Expirable TD" } -
    Issue 148: Discovery context and namespace under w3.org/ns
    +
    Issue 148: Discovery context and namespace under w3.org/ns
    The context URIs are tentative and subject to change.
    @@ -3039,15 +3027,12 @@

    Web of Things (WoT) Discovery

    } ] } -
    Issue 150: Definition of Problem Details error types Stretch goalDiscuss2021-10 F2F

    - This example skips the type field - due to the current lack of WoT-specific error types. -

    + -
    Issue 99: Define requirements and add section for validation

    How much validation does a directory need to do?

    +
    Issue 99: Define requirements and add section for validation

    How much validation does a directory need to do?

    1. If it only supports syntactic queries, is JSONSchema validation sufficient? Do we also use SHACL?
    2. If we support SPARQL, do we need to do more to make sure the ontologies used are correct?
      3. @@ -3125,9 +3110,7 @@

      Web of Things (WoT) Discovery

      -
      Issue 176: Event payload filtering Stretch goal2021-10 F2F
      - Event filtering based on the payload is work in progress. -
      +
      Event Data

      @@ -3183,7 +3166,7 @@

      Web of Things (WoT) Discovery

      data: "title": "Simple TD" data: } id: event_1 -
      Issue 148: Discovery context and namespace under w3.org/ns
      +
      Issue 148: Discovery context and namespace under w3.org/ns
      The context URIs are tentative and subject to change.
      @@ -3283,14 +3266,7 @@

      Web of Things (WoT) Discovery

      7.3.2.3.1 Syntactic search: JSONPath

      This section is non-normative.

      -
      Issue 234: JSONPath as a search query language Propose ClosingConsolidation
      - The standardization of JSONPath expressions is in progress by an independent working group. - This section remains non-normative until the release of final - JSONPath specification by IETF. - In the meantime, clients should consider the JSONPath API - as unstable and expect deviations across - Thing Description Directory implementations. -
      + Support for JSONPath Search API is optional. If implemented, the JSONPath API must allow searching TDs using an HTTP GET request at /search/jsonpath?query={query} endpoint, where query is the JSONPath expression. @@ -3842,10 +3818,7 @@

      Web of Things (WoT) Discovery

      } -
      Issue 82: Creation of OpenAPI spec from Directory TD

      - Need to confirm if equivalent OpenAPI spec can be easily created out of the TM. - If yes, a sentence may be added indicating this possibility. -

      +
      Editor's note: Context URIs

      The context URIs are tentative and subject to change.

      @@ -4343,7 +4316,7 @@

      Web of Things (WoT) Discovery

      Link Target Attribute Values sub-registry of the Constrained Restful Environments (CoRE) Parameters registry defined in [RFC6690].

      - +
      @@ -4359,7 +4332,7 @@

      Web of Things (WoT) Discovery

      - + @@ -4740,9 +4713,7 @@

      Web of Things (WoT) Discovery

    3. § 7.3.1.1 Registration Information
    4. - § 7.3.2.3.1 Syntactic search: JSONPath -
    5. - § 11.3 CoRE Resource Types Registration + § 11.3 CoRE Resource Types Registration
      6. -
      -
      Editor's note: Directory Information Model
      -

      To Do: Formal definition of information contained in a -directory and its organization.

      -
      As shown in @@ -4060,8 +4053,8 @@
      7.3.2.2 "secno">7.3.2.4 API Specification (Thing Model), namely: thingCreated, thingUpdated, and thingDeleted.

      -
      -
      +
      Editor's note: SSE Authorization Header

      Some early SSE implementations (including HTML5 @@ -4079,8 +4072,8 @@

      7.3.2.3 Search API
      -
      -
      +
      Editor's note: Search API Overview

      Sub-API to search a directory, e.g. issue a query. @@ -5104,8 +5097,8 @@

      -
      -
      +
      Editor's note: Context URIs

      The context URIs are tentative and subject to diff --git a/publication/3-wd/index.html b/publication/3-wd/index.html index b2bd4f86..239e6fd0 100644 --- a/publication/3-wd/index.html +++ b/publication/3-wd/index.html @@ -1157,9 +1157,11 @@

      Thing Description Directory

      Information Model

      + As shown in [[[#exploration-class-diagram]]], the Thing Description Directory can contain zero or more TDs. diff --git a/publication/3-wd/static.html b/publication/3-wd/static.html index d7baf66d..b5bb5163 100644 --- a/publication/3-wd/static.html +++ b/publication/3-wd/static.html @@ -2110,9 +2110,7 @@

      Web of Things (WoT) Discovery

      7.3.1 Information Model

      -
      Editor's note: Directory Information Model

      - To Do: Formal definition of information contained in a directory and its organization. -

      + As shown in Figure 4, the Thing Description Directory can contain zero or more TDs. @@ -3222,7 +3220,7 @@

      Web of Things (WoT) Discovery

      thingCreated, thingUpdated, and thingDeleted.

      -
      Editor's note: SSE Authorization Header

      +

      Editor's note: SSE Authorization Header

      Some early SSE implementations (including HTML5 EventSource) do not allow setting custom headers in the initial HTTP request. Authorization header is required in few OAuth2 flows and passing it as a query parameter is @@ -3237,7 +3235,7 @@

      Web of Things (WoT) Discovery

      From 838dda155378f2f814576b0915ed4f0d8db4ff34 Mon Sep 17 00:00:00 2001 From: Michael McCool Date: Mon, 4 Jul 2022 13:24:56 -0300 Subject: [PATCH 10/12] apply PR#370 --- publication/3-wd/Overview.html | 3 ++- publication/3-wd/index.html | 3 ++- publication/3-wd/static.html | 3 ++- 3 files changed, 6 insertions(+), 3 deletions(-) diff --git a/publication/3-wd/Overview.html b/publication/3-wd/Overview.html index fefc60fc..324cb03a 100644 --- a/publication/3-wd/Overview.html +++ b/publication/3-wd/Overview.html @@ -2627,7 +2627,8 @@

      7.2 class="internalDFN" data-link-type="dfn" id= "ref-for-dfn-td-16">TD MUST have a 2.05 (Content) status, contain a Content-Format option with value -432 (application/td+json), and the application/json) or 432 +(application/td+json), and the TD in the payload. Note that the payload might be split over multiple message exchanges using diff --git a/publication/3-wd/index.html b/publication/3-wd/index.html index 239e6fd0..154daaf1 100644 --- a/publication/3-wd/index.html +++ b/publication/3-wd/index.html @@ -1107,7 +1107,8 @@

      Thing Description Server

      A successful response from a CoAP-based TD Server providing a TD MUST have a 2.05 (Content) status, contain a Content-Format option - with value 432 (`application/td+json`), and the TD in the payload. + with value 50 (`application/json`) or 432 (`application/td+json`), + and the TD in the payload. Note that the payload might be split over multiple message exchanges using block-wise transfer [[RFC7959]]. diff --git a/publication/3-wd/static.html b/publication/3-wd/static.html index b5bb5163..be000398 100644 --- a/publication/3-wd/static.html +++ b/publication/3-wd/static.html @@ -2060,7 +2060,8 @@

      Web of Things (WoT) Discovery

      A successful response from a CoAP-based TD Server providing a TD MUST have a 2.05 (Content) status, contain a Content-Format option - with value 432 (application/td+json), and the TD in the payload. + with value 50 (application/json) or 432 (application/td+json), + and the TD in the payload.       Note that the payload might be split over multiple message exchanges using block-wise transfer [RFC7959]. From b733fa915aeb63061243a1e9b77f3e88b1c628a5 Mon Sep 17 00:00:00 2001 From: Michael McCool Date: Mon, 4 Jul 2022 13:31:04 -0300 Subject: [PATCH 11/12] update change log --- publication/3-wd/Overview.html | 50 ++++++++++++++++++++++++++++++---- publication/3-wd/index.html | 24 ++++++++++++++-- publication/3-wd/static.html | 26 +++++++++++++++--- 3 files changed, 87 insertions(+), 13 deletions(-) diff --git a/publication/3-wd/Overview.html b/publication/3-wd/Overview.html index 324cb03a..4d4137ce 100644 --- a/publication/3-wd/Overview.html +++ b/publication/3-wd/Overview.html @@ -1387,8 +1387,11 @@

      Table of "secno">A. Recent Specification Changes
      1. A.1 Changes -from First Draft
        2. +"#changes-from-second-draft">A.1 Changes +from 2 June 2021 Working Draft +
      2. A.2 Changes +from 24 November 2020 First Public Working Draft
    6. A. Recent Specification Changes

      7. -
      +
      -

      A.1 -Changes from First Draft

      -A.1 +Changes from 2 June 2021 Working Draft
      +
        +
      • Use wot for well-known URI service name.
        • +
      • Refer to TD and Architecture specs for general constraints on +secure transport.
        • +
      • Define requirements for CoAP-based TD Servers.
        • +
      • Introduction of TD Server exploration, with self-description as +a special case.
        • +
      • Elaboration of class diagram to clarify that not all +Directories need to be self-describing.
        • +
      • Clarify and consolidate error codes and ontology.
        • +
      • Add assertions for UTF-8 supporting internationalization.
        • +
      • Update overview figure showing introduction and exploration +mechanisms.
        • +
      • Add Discoverer section defining requirements for discovery +clients.
        • +
      • Use Thing Model instead of a Thing Description example for +Directory API.
        • +
      • Refactor Directory Service API (td->thing, split anonymous +create action, retrieve one and search as actions, listing as +things property, split events)
      • Add amplification DDOS security consideration.
      • Split Security and Privacy Considerations into separate sections.
        • +
      • Define status of search mechanisms: JSON Path, XPath, and +SPARQL.
        • +
      • Pagination as array and pagination as collection.
        • +
      • Updates to events API.
        • +
      • TD expiry management.
        • +
      • HEAD method support.
        • +
      + +
      +
      +

      A.2 +Changes from 24 November 2020 First Public Working Draft

      +
      +
      • Update name of directory service to "Thing Description Directory" with acronym TDD, to avoid confusion with the acronym TD used for Thing Descriptions.
        • diff --git a/publication/3-wd/index.html b/publication/3-wd/index.html index 154daaf1..05b4deeb 100644 --- a/publication/3-wd/index.html +++ b/publication/3-wd/index.html @@ -3434,13 +3434,32 @@

        CoRE Resource Types Registration

      - +

      Recent Specification Changes

      -

      Changes from First Draft

      +

      Changes from 2 June 2021 Working Draft

        +
      • Use wot for well-known URI service name.
        • +
      • Refer to TD and Architecture specs for general constraints on secure transport.
        • +
      • Define requirements for CoAP-based TD Servers.
        • +
      • Introduction of TD Server exploration, with self-description as a special case.
        • +
      • Elaboration of class diagram to clarify that not all Directories need to be self-describing.
        • +
      • Clarify and consolidate error codes and ontology.
        • +
      • Add assertions for UTF-8 supporting internationalization.
        • +
      • Update overview figure showing introduction and exploration mechanisms.
        • +
      • Add Discoverer section defining requirements for discovery clients.
        • +
      • Use Thing Model instead of a Thing Description example for Directory API.
        • +
      • Refactor Directory Service API (td->thing, split anonymous create action, retrieve one and search as actions, listing as things property, split events)
      • Add amplification DDOS security consideration.
      • Split Security and Privacy Considerations into separate sections.
        • +
      • Define status of search mechanisms: JSON Path, XPath, and SPARQL.
        • +
      • Pagination as array and pagination as collection.
        • +
      • Updates to events API.
        • +
      • TD expiry management.
        • +
      • HEAD method support.
        • +
      +

      Changes from 24 November 2020 First Public Working Draft

      +
      • Update name of directory service to "Thing Description Directory" with acronym TDD, to avoid confusion with the acronym TD used for Thing Descriptions.
        • @@ -3489,7 +3508,6 @@

        Changes from First Draft

      -

      Acknowledgments

      Value
      wot.directoryDirectory Description of a Thing Description DirectoryDirectory Description of a Thing Description Directory 6.4 CoRE Link Format and CoRE Resource Directory