From f2f639ae385a5b8a141afd147507018056dc41c6 Mon Sep 17 00:00:00 2001 From: "camara-release-automation[bot]" <261643975+camara-release-automation[bot]@users.noreply.github.com> Date: Fri, 7 Aug 2026 10:35:34 +0000 Subject: [PATCH 1/2] chore: post-release sync for r2.1 --- CHANGELOG/CHANGELOG-r2.md | 102 ++++++++++++++++++++++++++++++++++++++ README.md | 26 ++++++---- 2 files changed, 118 insertions(+), 10 deletions(-) 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..f29db3c --- /dev/null +++ b/CHANGELOG/CHANGELOG-r2.md @@ -0,0 +1,102 @@ +# Changelog DeviceReachabilityStatus + + +## 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-reachability-status-subscriptions 0.9.0-rc.1 +* device-reachability-status 1.2.0-rc.3 + +The API definition(s) are based on +* Commonalities 0.8.0 +* Identity and Consent Management 0.5.0 + +## device-reachability-status-subscriptions 0.9.0-rc.1 + +**device-reachability-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/DeviceReachabilityStatus/r2.1/code/API_definitions/device-reachability-status-subscriptions.yaml&nocors) + - [View it on Swagger Editor](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/DeviceReachabilityStatus/r2.1/code/API_definitions/device-reachability-status-subscriptions.yaml) + - OpenAPI [YAML spec file](https://github.com/camaraproject/DeviceReachabilityStatus/blob/r2.1/code/API_definitions/device-reachability-status-subscriptions.yaml) + +### Breaking changes + +* Update API definitions to fix CAMARA validation warnings and hints by @eric-murray in https://github.com/camaraproject/DeviceReachabilityStatus/pull/63 + - 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 + +* N/A + +### Changed + +* Update API definitions to fix CAMARA validation warnings and hints by @eric-murray in https://github.com/camaraproject/DeviceReachabilityStatus/pull/63 + - 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 + +* Fix network identifier example by @bigludo7 in https://github.com/camaraproject/DeviceReachabilityStatus/pull/55 + +### Removed + +* Delete redundant API Readiness Checklists by @eric-murray in https://github.com/camaraproject/DeviceReachabilityStatus/pull/71 + +## device-reachability-status 1.2.0-rc.3 + +**device-reachability-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/DeviceReachabilityStatus/r2.1/code/API_definitions/device-reachability-status.yaml&nocors) + - [View it on Swagger Editor](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/DeviceReachabilityStatus/r2.1/code/API_definitions/device-reachability-status.yaml) + - OpenAPI [YAML spec file](https://github.com/camaraproject/DeviceReachabilityStatus/blob/r2.1/code/API_definitions/device-reachability-status.yaml) + +### Breaking changes + +* N/A + +### Added + +* N/A + +### Changed + +* Clarify LastStatusTime description in YAML by @eric-murray in https://github.com/camaraproject/DeviceReachabilityStatus/pull/51 +* Update API definitions to fix CAMARA validation warnings and hints by @eric-murray in https://github.com/camaraproject/DeviceReachabilityStatus/pull/63 + +### Fixed + +* Update description for RequestReachabilityStatus by @eric-murray in https://github.com/camaraproject/DeviceReachabilityStatus/pull/52 +* Fix network identifier example by @bigludo7 in https://github.com/camaraproject/DeviceReachabilityStatus/pull/55 + +### Removed + +* Delete redundant API Readiness Checklists by @eric-murray in https://github.com/camaraproject/DeviceReachabilityStatus/pull/71 + +**Full Changelog**: https://github.com/camaraproject/DeviceReachabilityStatus/compare/r1.2...r2.1 + diff --git a/README.md b/README.md index 863c362..ad36346 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/DeviceReachabilityStatus/releases/tag/r1.2) (Fall25), with the following API versions: - * **device-reachability-status-subscriptions v0.8.0** - [[YAML]](https://github.com/camaraproject/DeviceReachabilityStatus/blob/r1.2/code/API_definitions/device-reachability-status-subscriptions.yaml) - [[ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/DeviceReachabilityStatus/r1.2/code/API_definitions/device-reachability-status-subscriptions.yaml&nocors) - [[Swagger]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/DeviceReachabilityStatus/r1.2/code/API_definitions/device-reachability-status-subscriptions.yaml) - * **device-reachability-status v1.1.0** - [[YAML]](https://github.com/camaraproject/DeviceReachabilityStatus/blob/r1.2/code/API_definitions/device-reachability-status.yaml) - [[ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/DeviceReachabilityStatus/r1.2/code/API_definitions/device-reachability-status.yaml&nocors) - [[Swagger]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/DeviceReachabilityStatus/r1.2/code/API_definitions/device-reachability-status.yaml) +* The latest public release is [r1.2](https://github.com/camaraproject/DeviceReachabilityStatus/releases/tag/r1.2), with the following API versions: + * **device-reachability-status-subscriptions 0.8.0** + [[YAML]](https://github.com/camaraproject/DeviceReachabilityStatus/blob/r1.2/code/API_definitions/device-reachability-status-subscriptions.yaml) [[ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/DeviceReachabilityStatus/r1.2/code/API_definitions/device-reachability-status-subscriptions.yaml&nocors) [[Swagger]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/DeviceReachabilityStatus/r1.2/code/API_definitions/device-reachability-status-subscriptions.yaml) + * **device-reachability-status 1.1.0** + [[YAML]](https://github.com/camaraproject/DeviceReachabilityStatus/blob/r1.2/code/API_definitions/device-reachability-status.yaml) [[ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/DeviceReachabilityStatus/r1.2/code/API_definitions/device-reachability-status.yaml&nocors) [[Swagger]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/DeviceReachabilityStatus/r1.2/code/API_definitions/device-reachability-status.yaml) + * The latest public release is always available here: https://github.com/camaraproject/DeviceReachabilityStatus/releases/latest * Other releases of this repository are available in https://github.com/camaraproject/DeviceReachabilityStatus/releases -* For changes see [CHANGELOG.md](https://github.com/camaraproject/DeviceReachabilityStatus/blob/main/CHANGELOG.md) +* For changes see [CHANGELOG](https://github.com/camaraproject/DeviceReachabilityStatus/tree/main/CHANGELOG) + +### Upcoming Release Preview + +* Pre-release: [r2.1](https://github.com/camaraproject/DeviceReachabilityStatus/releases/tag/r2.1) (release candidate) + * **device-reachability-status-subscriptions 0.9.0-rc.1** + [[YAML]](https://github.com/camaraproject/DeviceReachabilityStatus/blob/r2.1/code/API_definitions/device-reachability-status-subscriptions.yaml) [[ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/DeviceReachabilityStatus/r2.1/code/API_definitions/device-reachability-status-subscriptions.yaml&nocors) [[Swagger]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/DeviceReachabilityStatus/r2.1/code/API_definitions/device-reachability-status-subscriptions.yaml) + * **device-reachability-status 1.2.0-rc.3** + [[YAML]](https://github.com/camaraproject/DeviceReachabilityStatus/blob/r2.1/code/API_definitions/device-reachability-status.yaml) [[ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/DeviceReachabilityStatus/r2.1/code/API_definitions/device-reachability-status.yaml&nocors) [[Swagger]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/DeviceReachabilityStatus/r2.1/code/API_definitions/device-reachability-status.yaml) + _The above section is automatically synchronized by CAMARA project-administration._ From 442386d11124b963af3aa48daa6f142760143fcf Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Fri, 7 Aug 2026 11:38:27 +0100 Subject: [PATCH 2/2] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index ad36346..8f2b28b 100644 --- a/README.md +++ b/README.md @@ -57,9 +57,9 @@ _The above section is automatically synchronized by CAMARA project-administratio * Meetings are held virtually - * Schedule: Bi-weekly on Wednesday, 09:00 UTC + * Schedule: Bi-weekly on Friday, 14:00 UTC * [Registration / Join](https://zoom-lfx.platform.linuxfoundation.org/meeting/93413850406?password=3aeb0f1b-d9f9-42c5-91d8-3d2b20421ef1) - * Access [meeting minutes](https://lf-camaraproject.atlassian.net/wiki/x/fzLe) + * Access [meeting minutes](https://lf-camaraproject.atlassian.net/wiki/spaces/CAM/pages/14555224/Minutes+-+Device+Status) * Mailing List