Skip to content

Commit

Permalink
Merge pull request #22 from camaraproject/jgarciahospital-patch-5
Browse files Browse the repository at this point in the history
Create RC version of Device Swap
  • Loading branch information
jgarciahospital authored Oct 30, 2024
2 parents 0e6e74d + ae00ee5 commit 8d1bf26
Show file tree
Hide file tree
Showing 4 changed files with 79 additions and 3 deletions.
48 changes: 48 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -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
12 changes: 11 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 <!-- for new API families request a meeting link from the LF admin team or replace the information with the existing meeting information (of the API family) -->
Expand All @@ -26,3 +34,5 @@ Repository to describe, develop, document and test the Device Swap API family
<!-- Note: the $sub-project-mailinglistname$ is either already existing or will be created by the CAMARA Admin Team -->
* Subscribe / Unsubscribe to the mailing list of this Sub Project <https://lists.camaraproject.org/g/sp-dsw>.
* A message to the community of this Sub Project can be sent using <sp-dsw@lists.camaraproject.org>.


4 changes: 2 additions & 2 deletions code/API_definitions/device-swap.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
@@ -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<br>public | stable<br> 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 | |

0 comments on commit 8d1bf26

Please sign in to comment.