diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..6fc2cb5 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,48 @@ +# Changelog DeviceSwap + +## Table of Contents + +- [r1.1](#r11) + +**Please be aware that the project will have frequent updates to the main branch. There are no compatibility guarantees associated with code in any branch, including main, until it has been released. For example, changes may be reverted before a release is published. For the best results, use the latest published release.** + +# r1.1 +## Release Notes + +This release contains the definition and documentation of +* device-swap v0.1.0-rc.1 + +The API definition(s) are based on +* Commonalities v0.4.0 +* Identity and Consent Management v0.2.1 + +## device-swap v0.1.0-rc.1 + +**device-swap v0.1.0-rc.1 is the 1st release candidate of the version 0.1.0** + +- 0.1.0-rc.1 Device Swap API definition **with inline documentation**: + - OpenAPI [YAML spec file](https://github.com/camaraproject/DeviceSwap/blob/r1.1/code/API_definitions/device-swap.yaml) + - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/DeviceSwap/blob/r1.1/code/API_definitions/device-swap.yaml&nocors) + - [View it on Swagger Editor](https://editor.swagger.io/?url=https://raw.githubusercontent.com/camaraproject/DeviceSwap/blob/r1.1/code/API_definitions/device-swap.yaml) + +## What's Changed +### Added +* Initial proposal for Device Swap API by @jgarciahospital in https://github.com/camaraproject/DeviceSwap/pull/13 +* Clean error and description by @jgarciahospital in https://github.com/camaraproject/DeviceSwap/pull/18 +* Updated device-swap description by @jgarciahospital in https://github.com/camaraproject/DeviceSwap/pull/17 +* Updated API actions descriptions by @jgarciahospital in https://github.com/camaraproject/DeviceSwap/pull/21 +* Create Gherkin tests for Device Swap API by @jgarciahospital in https://github.com/camaraproject/DeviceSwap/pull/23 +* Include User stories for Device Swap by @jgarciahospital in https://github.com/camaraproject/DeviceSwap/pull/24 + +### Changed +N/A +### Fixed +N/A +### Removed +N/A + +## New Contributors +* @bigludo7 made their first contribution in https://github.com/camaraproject/DeviceSwap/pull/8 +* @jgarciahospital made their first contribution in https://github.com/camaraproject/DeviceSwap/pull/13 + +**Full Changelog**: https://github.com/camaraproject/DeviceSwap/commits/r1.1 diff --git a/README.md b/README.md index c8e4090..08d5386 100644 --- a/README.md +++ b/README.md @@ -15,7 +15,15 @@ Repository to describe, develop, document and test the Device Swap API family * NOTE: The scope of this API family should be limited (at least at a first stage) to 4G and 5G. * Describe, develop, document and test the APIs (with 1-2 Telcos) * Started: July 2024 -* Location: virtually +* Location: virtually + +## Release Information +* Note: Please be aware that the project will have frequent 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**. +* The pre-release r1.1 contains the version 0.1.0-rc.1 of the Device Swap API. It is the first release candidate of the v0.1.0. The release tag is [r1.1](https://github.com/camaraproject/DeviceSwap/tree/r1.1). +- 0.1.0-rc.1 Device Swap API definition **with inline documentation**: + - OpenAPI [YAML spec file](https://github.com/camaraproject/DeviceSwap/blob/r1.1/code/API_definitions/device-swap.yaml) + - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/DeviceSwap/r1.1/code/API_definitions/device-swap.yaml&nocors) + - [View it on Swagger Editor](https://editor.swagger.io/?url=https://raw.githubusercontent.com/camaraproject/DeviceSwap/r1.1/code/API_definitions/device-swap.yaml) ## Contributing * Meetings are held virtually @@ -26,3 +34,5 @@ Repository to describe, develop, document and test the Device Swap API family * Subscribe / Unsubscribe to the mailing list of this Sub Project . * A message to the community of this Sub Project can be sent using . + + diff --git a/code/API_definitions/device-swap.yaml b/code/API_definitions/device-swap.yaml index 9df9953..f52a185 100644 --- a/code/API_definitions/device-swap.yaml +++ b/code/API_definitions/device-swap.yaml @@ -60,10 +60,10 @@ info: license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html - version: wip + version: 0.1.0-rc.1 x-camara-commonalities: 0.4.0 servers: - - url: '{apiRoot}/device-swap/vwip' + - url: '{apiRoot}/device-swap/v0.1rc1' variables: apiRoot: default: http://localhost:9091 diff --git a/documentation/SupportingDocuments/device-swap-API-Readiness-Checklist.md b/documentation/SupportingDocuments/device-swap-API-Readiness-Checklist.md new file mode 100644 index 0000000..48a3233 --- /dev/null +++ b/documentation/SupportingDocuments/device-swap-API-Readiness-Checklist.md @@ -0,0 +1,18 @@ +# API Readiness Checklist + +Checklist for device-swap 0.1.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 | [link](/code/API_definitions/device-swap.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 | Embed documentation into API spec - [link](/code/API_definitions/device-swap.yaml) | +| 6 | User stories | O | O | O | M | Y | [check](/documentation/API_documentation/device-swap_check_User_Story.md) [retrieve](/documentation/API_documentation/device-swap_retrieve_User_Story.md) | +| 7 | Basic API test cases & documentation | O | M | M | M | Y | [check](/code/Test_definitions/device-swap-check.feature) [retrieve](/code/Test_definitions/device-swap-retrieve-date.feature) | +| 8 | Enhanced API test cases & documentation | O | O | O | M | Y | [check](/code/Test_definitions/device-swap-check.feature) [retrieve](/code/Test_definitions/device-swap-retrieve-date.feature) | +| 9 | Test result statement | O | O | O | M | N | | +| 10 | API release numbering convention applied | M | M | M | M | Y | | +| 11 | Change log updated | M | M | M | M | Y | [link](/CHANGELOG.md) | +| 12 | Previous public release was certified | O | O | O | M | N | |