From 00183f190be35edd216f2ef1aa4c977a1b20d270 Mon Sep 17 00:00:00 2001 From: arnoweiss Date: Thu, 17 Aug 2023 13:26:09 +0200 Subject: [PATCH] minor bugfixes arisen in qg4 review --- .../page_software-development-view.md | 4 ++-- .../kits/Digital Twin Kit/page_adoption-view.md | 10 +++++----- docs-kits/kits/Digital Twin Kit/page_changelog.md | 12 +++++++++++- openApi/dt/discovery-finder-openapi.yaml | 2 ++ 4 files changed, 20 insertions(+), 8 deletions(-) diff --git a/docs-kits/kits/Digital Twin Kit/Software Development View/page_software-development-view.md b/docs-kits/kits/Digital Twin Kit/Software Development View/page_software-development-view.md index d4cd812dcce..32535e4661d 100644 --- a/docs-kits/kits/Digital Twin Kit/Software Development View/page_software-development-view.md +++ b/docs-kits/kits/Digital Twin Kit/Software Development View/page_software-development-view.md @@ -15,7 +15,7 @@ Development View of the Kit. ## API Specifications -All openAPI-specifications for the Digital Twin Kit services are rendered in the section [of these docs](API%20Specs) +All openAPI-specifications for the Digital Twin Kit services are rendered in the section [of these docs](API%20AAS%20Discovery/dotaas-part-2-http-rest-discovery-service-specification.info.mdx) ### Asset Administration Shell @@ -271,7 +271,7 @@ The top-level `@id` field should be equivalent to the id of the Submodel. "1.1" ], "subprotocol": "DSP", - "subprotocolBody": "body with information required by subprotocol", + "subprotocolBody": "id=123;dspEndpoint=http://edc.control.plane/", "subprotocolBodyEncoding": "plain", "securityAttributes": [ { diff --git a/docs-kits/kits/Digital Twin Kit/page_adoption-view.md b/docs-kits/kits/Digital Twin Kit/page_adoption-view.md index c0b4803d8be..53018a65125 100644 --- a/docs-kits/kits/Digital Twin Kit/page_adoption-view.md +++ b/docs-kits/kits/Digital Twin Kit/page_adoption-view.md @@ -80,12 +80,12 @@ For more info how specifically the Asset Administration Shell is used, consult t ### CX-Standards -- [CX - 0001 EDC Discovery API](https://catena-x.net/fileadmin/user_upload/Standard-Bibliothek/Update_PDF_Maerz/9_Data-Discovery-Services/CX_-_0001_EDC_DISCOVERY_API_PlatformCapabilityDS_v_1.0.1-1.pdf) -- [CX - 0002 Digital Twins in Catena-X](https://catena-x.net/fileadmin/user_upload/Standard-Bibliothek/Archiv/Update_Juli_23_R_3.2/CX-0002-DigitalTwinsInCatena-X-v.1.0.2.pdf) -- CX - 0053 BPN Discovery Services *(will be released publicly with R3.2 in ca 09/23)* +- [CX - 0001 EDC Discovery API](https://catena-x.net/fileadmin/user_upload/Standard-Bibliothek/Update_PDF_Maerz/9_Data-Discovery-Services/CX_-_0001_EDC_DISCOVERY_API_PlatformCapabilityDS_v_1.0.1-1.pdf) +- [CX - 0002 Digital Twins in Catena-X](https://catena-x.net/fileadmin/user_upload/Standard-Bibliothek/Archiv/Update_Juli_23_R_3.2/CX-0002-DigitalTwinsInCatena-X-v.1.0.2.pdf)*(linked version 1.0.2, this KIT refers to v2.0.0, to be released in 09/23)* +- CX - 0053 BPN Discovery Services *(v1.0.0 to be released in 09/23)* ### Terminology -The following figure is borrowed from the upcoming R3.2 release of "Digital Twins in Catena-X" standard. It is -non-normative and shall only serve as a visual orientation for readers. +The following figure is also a non-normative part of CX-0002 "Digital Twins in Catena-X" v2.0.0. When published, that +standard can be found in the [Catena-X standard library](https://catena-x.net/de/standard-library). ![How words relate in the DT Kit](assets/img/DTKIT_terminology.svg) diff --git a/docs-kits/kits/Digital Twin Kit/page_changelog.md b/docs-kits/kits/Digital Twin Kit/page_changelog.md index 6bf2f955786..24f41ca778c 100644 --- a/docs-kits/kits/Digital Twin Kit/page_changelog.md +++ b/docs-kits/kits/Digital Twin Kit/page_changelog.md @@ -9,11 +9,21 @@ sidebar_position: 1 All notable changes to this Kit will be documented in this file. +## [1.0.0] - 2023-08-17 + +### Added + +- version from release + +### Changed + +- couple of bugfixes raised by reviewers + ## [0.2.0] - 2023-08-08 ### Added -- Additional graphic on terminology +- Additional figure on terminology - section on entire discovery mechanism - pictograms diff --git a/openApi/dt/discovery-finder-openapi.yaml b/openApi/dt/discovery-finder-openapi.yaml index 80cbbf861af..8f12a2bf1c5 100644 --- a/openApi/dt/discovery-finder-openapi.yaml +++ b/openApi/dt/discovery-finder-openapi.yaml @@ -105,6 +105,7 @@ components: schemas: DiscoveryEndpoint: title: DiscoveryEndpoint + type: object required: - type - description @@ -148,6 +149,7 @@ components: maxItems: 10000 items: $ref: '#/components/schemas/DiscoveryEndpoint' + type: object ErrorResponse: type: object required: