From 3d6821a606a316d30619575687ab49df1b3ee486 Mon Sep 17 00:00:00 2001 From: "camara-release-automation[bot]" <261643975+camara-release-automation[bot]@users.noreply.github.com> Date: Wed, 8 Jul 2026 07:52:17 +0000 Subject: [PATCH 1/5] Update README Release Information for r2.1 --- README.md | 26 ++++++++++++++++---------- 1 file changed, 16 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index edbaef5..f281e2f 100644 --- a/README.md +++ b/README.md @@ -31,18 +31,24 @@ Incubating API Repository to evolve and maintain the definitions and documentati > [!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**. -* **NEW**: The latest public release is [r1.2](https://github.com/camaraproject/DeviceRoamingStatus/releases/tag/r1.2) (Fall25), with the following API versions: - * **device-roaming-status-subscriptions v0.8.0** - [[YAML]](https://github.com/camaraproject/DeviceRoamingStatus/blob/r1.2/code/API_definitions/device-roaming-status-subscriptions.yaml) - [[ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r1.2/code/API_definitions/device-roaming-status-subscriptions.yaml&nocors) - [[Swagger]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r1.2/code/API_definitions/device-roaming-status-subscriptions.yaml) - * **device-roaming-status v1.1.0** - [[YAML]](https://github.com/camaraproject/DeviceRoamingStatus/blob/r1.2/code/API_definitions/device-roaming-status.yaml) - [[ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r1.2/code/API_definitions/device-roaming-status.yaml&nocors) - [[Swagger]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r1.2/code/API_definitions/device-roaming-status.yaml) +* The latest public release is [r1.2](https://github.com/camaraproject/DeviceRoamingStatus/releases/tag/r1.2), with the following API versions: + * **device-roaming-status-subscriptions 0.8.0** + [[YAML]](https://github.com/camaraproject/DeviceRoamingStatus/blob/r1.2/code/API_definitions/device-roaming-status-subscriptions.yaml) [[ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r1.2/code/API_definitions/device-roaming-status-subscriptions.yaml&nocors) [[Swagger]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r1.2/code/API_definitions/device-roaming-status-subscriptions.yaml) + * **device-roaming-status 1.1.0** + [[YAML]](https://github.com/camaraproject/DeviceRoamingStatus/blob/r1.2/code/API_definitions/device-roaming-status.yaml) [[ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r1.2/code/API_definitions/device-roaming-status.yaml&nocors) [[Swagger]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r1.2/code/API_definitions/device-roaming-status.yaml) + * The latest public release is always available here: https://github.com/camaraproject/DeviceRoamingStatus/releases/latest * Other releases of this repository are available in https://github.com/camaraproject/DeviceRoamingStatus/releases -* For changes see [CHANGELOG.md](https://github.com/camaraproject/DeviceRoamingStatus/blob/main/CHANGELOG.md) +* For changes see [CHANGELOG](https://github.com/camaraproject/DeviceRoamingStatus/tree/main/CHANGELOG) + +### Upcoming Release Preview + +* Pre-release: [r2.1](https://github.com/camaraproject/DeviceRoamingStatus/releases/tag/r2.1) (release candidate) + * **device-roaming-status-subscriptions 0.9.0-rc.1** + [[YAML]](https://github.com/camaraproject/DeviceRoamingStatus/blob/r2.1/code/API_definitions/device-roaming-status-subscriptions.yaml) [[ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r2.1/code/API_definitions/device-roaming-status-subscriptions.yaml&nocors) [[Swagger]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r2.1/code/API_definitions/device-roaming-status-subscriptions.yaml) + * **device-roaming-status 1.2.0-rc.3** + [[YAML]](https://github.com/camaraproject/DeviceRoamingStatus/blob/r2.1/code/API_definitions/device-roaming-status.yaml) [[ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r2.1/code/API_definitions/device-roaming-status.yaml&nocors) [[Swagger]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r2.1/code/API_definitions/device-roaming-status.yaml) + _The above section is automatically synchronized by CAMARA project-administration._ From 15cecf073635989f9cf228e7cc86a68cfc0b2e37 Mon Sep 17 00:00:00 2001 From: "camara-release-automation[bot]" <261643975+camara-release-automation[bot]@users.noreply.github.com> Date: Wed, 8 Jul 2026 07:52:19 +0000 Subject: [PATCH 2/5] Add CHANGELOG draft for r2.1 --- CHANGELOG/CHANGELOG-r2.md | 127 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 127 insertions(+) create mode 100644 CHANGELOG/CHANGELOG-r2.md diff --git a/CHANGELOG/CHANGELOG-r2.md b/CHANGELOG/CHANGELOG-r2.md new file mode 100644 index 0000000..86fd9ae --- /dev/null +++ b/CHANGELOG/CHANGELOG-r2.md @@ -0,0 +1,127 @@ +# Changelog DeviceRoamingStatus + + +## Table of Contents +- [r2.1](#r21) + + +**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.** + +The below sections record the changes for each API version in each release as follows: + +* for an alpha release, the delta with respect to the previous release +* for the first release-candidate, all changes since the last public release +* for subsequent release-candidate(s), only the delta to the previous release-candidate +* for a public release, the consolidated changes since the previous public release + +# r2.1 + +## Release Notes + +This release candidate contains the definition and documentation of +* device-roaming-status-subscriptions 0.9.0-rc.1 +* device-roaming-status 1.2.0-rc.3 + +The API definition(s) are based on +* Commonalities 0.8.0 +* Identity and Consent Management 0.5.0 + + +> **Working area — candidate changes (auto-removed on merge)** +> Copy relevant entries into the Breaking changes/Added/Changed/Fixed/Removed sections below. List breaking changes both in Breaking changes and in their normal change category. +> You may edit this list while triaging; it will be removed on merge. +> This working-area section is removed automatically when the PR is merged. + +
+Candidate changes (auto-generated from merged PRs) + +## What's Changed +* Chore: Reset version numbers to wip following meta-release by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/51 +* Fix example label: Multiple Country Codes → Multiple Country Names by @sachinvodafone in https://github.com/camaraproject/DeviceRoamingStatus/pull/54 +* [bulk] Sync Release Information section (2025-12-12-001) by @hdamker-bot in https://github.com/camaraproject/DeviceRoamingStatus/pull/60 +* Clarify LastStatusTime schema description in YAML by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/56 +* Fix example for Network Access Identifier by @bigludo7 in https://github.com/camaraproject/DeviceRoamingStatus/pull/58 +* Fix version in info-version by @bigludo7 in https://github.com/camaraproject/DeviceRoamingStatus/pull/61 +* Add examples for roaming status retrieval by @bigludo7 in https://github.com/camaraproject/DeviceRoamingStatus/pull/53 +* [bulk] Add release-plan.yaml (2026-02-23-001) by @hdamker-bot in https://github.com/camaraproject/DeviceRoamingStatus/pull/62 +* [bulk] Enable release automation and validation by @camara-release-automation[bot] in https://github.com/camaraproject/DeviceRoamingStatus/pull/69 +* Update release plan for Sync26 by @rartych in https://github.com/camaraproject/DeviceRoamingStatus/pull/68 +* fix: declare CloudEvent schema type by @hdamker in https://github.com/camaraproject/DeviceRoamingStatus/pull/77 +* Sync common files from Commonalities r4.3 by @camara-release-automation[bot] in https://github.com/camaraproject/DeviceRoamingStatus/pull/75 +* Delete redundant API Readiness Checklists by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/82 +* Update API definitions to fix CAMARA validation warnings and hints by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/78 +* Delete redundant workflow files by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/87 +* Append Local to overridden schema to avoid renaming warnings by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/86 + +## New Contributors +* @sachinvodafone made their first contribution in https://github.com/camaraproject/DeviceRoamingStatus/pull/54 +* @camara-release-automation[bot] made their first contribution in https://github.com/camaraproject/DeviceRoamingStatus/pull/69 +* @rartych made their first contribution in https://github.com/camaraproject/DeviceRoamingStatus/pull/68 + +
+ + +## device-roaming-status-subscriptions 0.9.0-rc.1 + +**device-roaming-status-subscriptions 0.9.0-rc.1 is a release-candidate version of this API.** + +Changes documented below are compared to version 0.8.0. + +- API definition **with inline documentation**: + - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r2.1/code/API_definitions/device-roaming-status-subscriptions.yaml&nocors) + - [View it on Swagger Editor](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r2.1/code/API_definitions/device-roaming-status-subscriptions.yaml) + - OpenAPI [YAML spec file](https://github.com/camaraproject/DeviceRoamingStatus/blob/r2.1/code/API_definitions/device-roaming-status-subscriptions.yaml) + +### Breaking changes + +* N/A + +### Added + +* N/A + +### Changed + +* N/A + +### Fixed + +* N/A + +### Removed + +* N/A + +## device-roaming-status 1.2.0-rc.3 + +**device-roaming-status 1.2.0-rc.3 is a release-candidate version of this API.** + +Changes documented below are compared to version 1.1.0. + +- API definition **with inline documentation**: + - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r2.1/code/API_definitions/device-roaming-status.yaml&nocors) + - [View it on Swagger Editor](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r2.1/code/API_definitions/device-roaming-status.yaml) + - OpenAPI [YAML spec file](https://github.com/camaraproject/DeviceRoamingStatus/blob/r2.1/code/API_definitions/device-roaming-status.yaml) + +### Breaking changes + +* N/A + +### Added + +* N/A + +### Changed + +* N/A + +### Fixed + +* N/A + +### Removed + +* N/A + +**Full Changelog**: https://github.com/camaraproject/DeviceRoamingStatus/compare/r1.2...r2.1 + From 9d63717da595cf02f4fdfbc6bbcf5134308b8ae4 Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Wed, 8 Jul 2026 14:38:03 +0100 Subject: [PATCH 3/5] Update CHANGELOG with recent changes and fixes Added examples for roaming status retrieval, updated API definitions to fix validation warnings, fixed CloudEvent schema type declaration, clarified LastStatusTime schema description, and deleted redundant API Readiness Checklists. --- CHANGELOG/CHANGELOG-r2.md | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/CHANGELOG/CHANGELOG-r2.md b/CHANGELOG/CHANGELOG-r2.md index 86fd9ae..72fae58 100644 --- a/CHANGELOG/CHANGELOG-r2.md +++ b/CHANGELOG/CHANGELOG-r2.md @@ -78,19 +78,19 @@ Changes documented below are compared to version 0.8.0. ### Added -* N/A +* Add examples for roaming status retrieval by @bigludo7 in https://github.com/camaraproject/DeviceRoamingStatus/pull/53 ### Changed -* N/A +* Update API definitions to fix CAMARA validation warnings and hints by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/78 ### Fixed -* N/A +* fix: declare CloudEvent schema type by @hdamker in https://github.com/camaraproject/DeviceRoamingStatus/pull/77 ### Removed -* N/A +* Delete redundant API Readiness Checklists by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/82 ## device-roaming-status 1.2.0-rc.3 @@ -113,15 +113,17 @@ Changes documented below are compared to version 1.1.0. ### Changed -* N/A +* Clarify LastStatusTime schema description in YAML by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/56 +* Update API definitions to fix CAMARA validation warnings and hints by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/78 ### Fixed -* N/A +* Fix example label: Multiple Country Codes → Multiple Country Names by @sachinvodafone in https://github.com/camaraproject/DeviceRoamingStatus/pull/54 +* Fix example for Network Access Identifier by @bigludo7 in https://github.com/camaraproject/DeviceRoamingStatus/pull/58 ### Removed -* N/A +* Delete redundant API Readiness Checklists by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/82 **Full Changelog**: https://github.com/camaraproject/DeviceRoamingStatus/compare/r1.2...r2.1 From 7a34ab155531dcc36d9be781059dd30dff4eb116 Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Wed, 8 Jul 2026 15:15:15 +0100 Subject: [PATCH 4/5] Update changelog with recent fixes and removals --- CHANGELOG/CHANGELOG-r2.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGELOG/CHANGELOG-r2.md b/CHANGELOG/CHANGELOG-r2.md index 72fae58..f63329b 100644 --- a/CHANGELOG/CHANGELOG-r2.md +++ b/CHANGELOG/CHANGELOG-r2.md @@ -87,6 +87,7 @@ Changes documented below are compared to version 0.8.0. ### Fixed * fix: declare CloudEvent schema type by @hdamker in https://github.com/camaraproject/DeviceRoamingStatus/pull/77 +* Fix example for Network Access Identifier by @bigludo7 in https://github.com/camaraproject/DeviceRoamingStatus/pull/58 ### Removed From fedfe138c1e5f0d4250158afe39ddc86644d347c Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Wed, 5 Aug 2026 17:12:42 +0100 Subject: [PATCH 5/5] Update CHANGELOG-r2.md --- CHANGELOG/CHANGELOG-r2.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/CHANGELOG/CHANGELOG-r2.md b/CHANGELOG/CHANGELOG-r2.md index f63329b..5930180 100644 --- a/CHANGELOG/CHANGELOG-r2.md +++ b/CHANGELOG/CHANGELOG-r2.md @@ -74,7 +74,11 @@ Changes documented below are compared to version 0.8.0. ### Breaking changes -* N/A +* Update API definitions to fix CAMARA validation warnings and hints by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/78 + - Pagination for listing of subscriptions using GET /subscriptions is now supported + - Addition of `page` and `perPage` query parameters to control pagination + - Returned subscriptions are now embedded in the array `subscriptions` within the response JSON, with the page tracked within the `pagination` JSON + - Addition of response headers `X-Total-Count`, `X-Total-Pages` and `Link` to facilitate page navigation ### Added @@ -83,6 +87,10 @@ Changes documented below are compared to version 0.8.0. ### Changed * Update API definitions to fix CAMARA validation warnings and hints by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/78 + - Pagination for listing of subscriptions using GET /subscriptions is now supported + - Addition of `page` and `perPage` query parameters to control pagination + - Returned subscriptions are now embedded in the array `subscriptions` within the response JSON, with the page tracked within the `pagination` JSON + - Addition of response headers `X-Total-Count`, `X-Total-Pages` and `Link` to facilitate page navigation ### Fixed