From 9c957ba79eae1067935475caf79dbe7552287fd1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jes=C3=BAs=20Pe=C3=B1a=20Garc=C3=ADa-Oliva?= Date: Thu, 22 Aug 2024 13:05:46 +0200 Subject: [PATCH] Public Release for Fall24 meta-release --- CHANGELOG.md | 51 +++++++++++++++++++ README.md | 17 +++---- ...devices_qod.yaml => home-devices-qod.yaml} | 2 +- ...ome-devices-qod-API-Readiness-Checklist.md | 6 +-- ...es.md => home-devices-qod-User-Stories.md} | 0 5 files changed, 61 insertions(+), 15 deletions(-) rename code/API_definitions/{home_devices_qod.yaml => home-devices-qod.yaml} (99%) rename documentation/API_documentation/{home_devices_qod_user_stories.md => home-devices-qod-User-Stories.md} (100%) diff --git a/CHANGELOG.md b/CHANGELOG.md index 4641ac9..9544e2b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,7 @@ ## Table of Contents +- **[r1.2](#r12)** - **[r1.1](#r11)** - [v0.3.0](#v030) - [v0.2.0](#v020) @@ -15,6 +16,56 @@ The below sections record the changes for each API version in each release as fo * for subsequent alpha or release-candidate API versions, the delta with respect to the previous pre-release * for a public API version, the consolidated changes since the release of the previous public API version +# r1.2 + +## Release Notes + +This release contains the definition and documentation of +* home-devices-qod v0.4.0 + +The API definition(s) are based on +* Commonalities v0.4.0 +* Identity and Consent Management v0.2.0 + +## home-devices-qod v0.4.0 + +**home-devices-qod v0.4.0 is the public release for v0.4.0 of the HomeDevicesQoD API.** + +- API definition **with inline documentation**: + - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/HomeDevicesQoD/r1.2/code/API_definitions/home-devices-qod.yaml&nocors) + - [View it on Swagger Editor](https://editor.swagger.io/?url=https://raw.githubusercontent.com/camaraproject/HomeDevicesQoD/r1.2/code/API_definitions/home-devices-qod.yaml) + - OpenAPI [YAML spec file](https://github.com/camaraproject/HomeDevicesQoD/blob/r1.2/code/API_definitions/home-devices-qod.yaml) + +**Main Changes** + +* API and test definitions updated to conform to the Commonalities v0.4.0 and Identity and Consent Management v0.2.0 guidelines included in the CAMARA Fall24 meta-release. No new features were added. + +### Added + +* N/A + +### Changed + +* Update and review codeowners and maintainers md file by @hdamker in https://github.com/camaraproject/HomeDevicesQoD/pull/62 +* Update README.md according to camaraproject/Template_Lead_Repository by @jpengar in https://github.com/camaraproject/HomeDevicesQoD/pull/67 +* API spec update for Fall24 meta-release by @jpengar in https://github.com/camaraproject/HomeDevicesQoD/pull/64 +* Update testing definitions in .feature file for Fall24 meta-release by @jpengar in https://github.com/camaraproject/HomeDevicesQoD/pull/65 +* Update with the new API-Readiness-Checklist.md for Fall24 meta-release by @jpengar in https://github.com/camaraproject/HomeDevicesQoD/pull/66 +* Update filenames to kebad-case format by @jpengar in https://github.com/camaraproject/HomeDevicesQoD/pull/70 + +### Fixed + +* N/A + +### Removed + +* N/A + +## New Contributors +* @hdamker made their first contribution in https://github.com/camaraproject/HomeDevicesQoD/pull/62 + +**Full Changelog**: https://github.com/camaraproject/HomeDevicesQoD/compare/v0.3.0...r1.2 + # r1.1 ## Release Notes diff --git a/README.md b/README.md index 035ee65..a7fdb58 100644 --- a/README.md +++ b/README.md @@ -18,18 +18,13 @@ Repository to describe, develop, document and test the HomeDevicesQoD API family ## Release Information * Note: Please be aware that the project will have updates to the main branch. There are no compatibility guarantees associated with code in any branch, including main, until a new release is created. For example, changes may be reverted before a release is created. **For best results, use the latest available release**. -* `NEW`: Pre-release r1.1 of API version `0.4.0-rc.1` is available [here](https://github.com/camaraproject/HomeDevicesQoD/tree/r1.1) +* `NEW`: Release r1.2 of API version `0.4.0` is available [here](https://github.com/camaraproject/HomeDevicesQoD/tree/r1.2) * API definition **with inline documentation**: - * [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/HomeDevicesQoD/r1.1/code/API_definitions/home_devices_qod.yaml&nocors) - * [View it on Swagger Editor](https://editor.swagger.io/?url=https://raw.githubusercontent.com/camaraproject/HomeDevicesQoD/r1.1/code/API_definitions/home_devices_qod.yaml) - * OpenAPI [YAML spec file](https://github.com/camaraproject/HomeDevicesQoD/blob/r1.1/code/API_definitions/home_devices_qod.yaml) - * API additional [related documentation](https://github.com/camaraproject/HomeDevicesQoD/tree/r1.1/documentation/API_documentation) -* **The previous release `v0.3.0` is available [here](https://github.com/camaraproject/HomeDevicesQoD/tree/v0.3.0)** - * API definition **with inline documentation**: - * [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/HomeDevicesQoD/v0.3.0/code/API_definitions/home_devices_qod.yaml&nocors) - * [View it on Swagger Editor](https://editor.swagger.io/?url=https://raw.githubusercontent.com/camaraproject/HomeDevicesQoD/v0.3.0/code/API_definitions/home_devices_qod.yaml) - * OpenAPI [YAML spec file](https://github.com/camaraproject/HomeDevicesQoD/blob/v0.3.0/code/API_definitions/home_devices_qod.yaml) - * API additional [related documentation](https://github.com/camaraproject/HomeDevicesQoD/tree/v0.3.0/documentation/API_documentation) + * [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/HomeDevicesQoD/r1.2/code/API_definitions/home-devices-qod.yaml&nocors) + * [View it on Swagger Editor](https://editor.swagger.io/?url=https://raw.githubusercontent.com/camaraproject/HomeDevicesQoD/r1.2/code/API_definitions/home-devices-qod.yaml) + * OpenAPI [YAML spec file](https://github.com/camaraproject/HomeDevicesQoD/blob/r1.2/code/API_definitions/home-devices-qod.yaml) + * API additional [related documentation](https://github.com/camaraproject/HomeDevicesQoD/tree/r1.2/documentation/API_documentation) +* The latest public release is available here: https://github.com/camaraproject/HomeDevicesQoD/releases/latest * Other releases of this sub project are available in https://github.com/camaraproject/HomeDevicesQoD/releases * For changes see [CHANGELOG.md](https://github.com/camaraproject/HomeDevicesQoD/blob/main/CHANGELOG.md) diff --git a/code/API_definitions/home_devices_qod.yaml b/code/API_definitions/home-devices-qod.yaml similarity index 99% rename from code/API_definitions/home_devices_qod.yaml rename to code/API_definitions/home-devices-qod.yaml index 9ba7108..b20c88f 100644 --- a/code/API_definitions/home_devices_qod.yaml +++ b/code/API_definitions/home-devices-qod.yaml @@ -59,7 +59,7 @@ info: license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html - version: 0.4.0-rc.1 + version: 0.4.0 x-camara-commonalities: 0.4.0 servers: - url: "{apiRoot}/home-devices-qod/v0.4rc1" diff --git a/documentation/API_documentation/home-devices-qod-API-Readiness-Checklist.md b/documentation/API_documentation/home-devices-qod-API-Readiness-Checklist.md index 5c3be06..3a03420 100644 --- a/documentation/API_documentation/home-devices-qod-API-Readiness-Checklist.md +++ b/documentation/API_documentation/home-devices-qod-API-Readiness-Checklist.md @@ -4,12 +4,12 @@ Checklist for home-devices-qod 0.4.0-rc.1 in r1.1 | Nr | API release assets | alpha | release-candidate | initial
public | stable
public | Status | Comments | |----|----------------------------------------------|:-----:|:-----------------:|:-------:|:------:|:----:|----| -| 1 | API definition | M | M | M | M | Y | [home_devices_qod.yaml](/code/API_definitions/home_devices_qod.yaml) | +| 1 | API definition | M | M | M | M | Y | [home-devices-qod.yaml](/code/API_definitions/home-devices-qod.yaml) | | 2 | Design guidelines from Commonalities applied | O | M | M | M | Y | | | 3 | Guidelines from ICM applied | O | M | M | M | Y | | | 4 | API versioning convention applied | M | M | M | M | Y | | -| 5 | API documentation | M | M | M | M | Y | Embedded in [API definition](/code/API_definitions/home_devices_qod.yaml) | -| 6 | User stories | O | O | O | M | Y | [home_devices_qod_user_stories.md](/documentation/API_documentation/home_devices_qod_user_stories.md) | +| 5 | API documentation | M | M | M | M | Y | Embedded in [API definition](/code/API_definitions/home-devices-qod.yaml) | +| 6 | User stories | O | O | O | M | Y | [home-devices-qod-User-Stories.md](/documentation/API_documentation/home-devices-qod-User-Stories.md) | | 7 | Basic API test cases & documentation | O | M | M | M | Y | [home-devices-qod.feature](/code/Test_definitions/home-devices-qod.feature) | | 8 | Enhanced API test cases & documentation | O | O | O | M | Y | [home-devices-qod.feature](/code/Test_definitions/home-devices-qod.feature) | | 9 | Test result statement | O | O | O | M | N | | diff --git a/documentation/API_documentation/home_devices_qod_user_stories.md b/documentation/API_documentation/home-devices-qod-User-Stories.md similarity index 100% rename from documentation/API_documentation/home_devices_qod_user_stories.md rename to documentation/API_documentation/home-devices-qod-User-Stories.md