From 7aaef0b286460f7ff9af0d767a29bfe562ff8b0a Mon Sep 17 00:00:00 2001 From: FabrizioMoggio <87469955+FabrizioMoggio@users.noreply.github.com> Date: Tue, 5 Aug 2025 09:10:48 +0200 Subject: [PATCH 1/7] Public OAS --- code/API_definitions/call-forwarding-signal.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/code/API_definitions/call-forwarding-signal.yaml b/code/API_definitions/call-forwarding-signal.yaml index 3fbcb67..baff8c3 100644 --- a/code/API_definitions/call-forwarding-signal.yaml +++ b/code/API_definitions/call-forwarding-signal.yaml @@ -151,7 +151,7 @@ info: # FAQ's (FAQs will be added in a later version of the documentation) - version: wip + version: 0.4.0 license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html @@ -163,7 +163,7 @@ externalDocs: # Servers # ############################################################################ servers: - - url: "{apiRoot}/call-forwarding-signal/vwip" + - url: "{apiRoot}/call-forwarding-signal/v0.4" variables: apiRoot: default: http://localhost:9091 From 8c3f72bf63fa5b7ea5bca6688ff696164043f687 Mon Sep 17 00:00:00 2001 From: FabrizioMoggio <87469955+FabrizioMoggio@users.noreply.github.com> Date: Tue, 5 Aug 2025 09:16:25 +0200 Subject: [PATCH 2/7] 0.4.0 public --- .../call-forwarding-signal-retrieveCallForwarding.feature | 4 ++-- ...warding-signal-retrieveUnconditionalCallForwarding.feature | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/code/Test_definitions/call-forwarding-signal-retrieveCallForwarding.feature b/code/Test_definitions/call-forwarding-signal-retrieveCallForwarding.feature index a06e910..95010a2 100644 --- a/code/Test_definitions/call-forwarding-signal-retrieveCallForwarding.feature +++ b/code/Test_definitions/call-forwarding-signal-retrieveCallForwarding.feature @@ -1,4 +1,4 @@ -Feature: CAMARA Call Forwarding Signal API, vwip - Operation retrieveCallForwarding +Feature: CAMARA Call Forwarding Signal API, v0.4.0 - Operation retrieveCallForwarding # Input to be provided by the implementation to the tester # # Implementation indications: @@ -8,7 +8,7 @@ Feature: CAMARA Call Forwarding Signal API, vwip - Operation retrieveCallForwar # * A device object identified by a phone number for which the call forwarding service status could not be retrieved # Background: Common call-forwarding-signal setup - Given the path "/call-forwarding-signal/vwip/call-forwardings" + Given the path "/call-forwarding-signal/v0.4/call-forwardings" And the header "Content-Type" is set to "application/json" And the header "Authorization" is set to a valid access token And the header "x-correlator" complies with the schema at "#/components/schemas/XCorrelator" diff --git a/code/Test_definitions/call-forwarding-signal-retrieveUnconditionalCallForwarding.feature b/code/Test_definitions/call-forwarding-signal-retrieveUnconditionalCallForwarding.feature index cf6e25c..8eef7ca 100644 --- a/code/Test_definitions/call-forwarding-signal-retrieveUnconditionalCallForwarding.feature +++ b/code/Test_definitions/call-forwarding-signal-retrieveUnconditionalCallForwarding.feature @@ -1,4 +1,4 @@ -Feature: CAMARA Call Forwarding Signal API, vwip - Operation retrieveUnconditionalCallForwarding +Feature: CAMARA Call Forwarding Signal API, v0.4.0 - Operation retrieveUnconditionalCallForwarding # Input to be provided by the implementation to the tester # # Implementation indications: @@ -8,7 +8,7 @@ Feature: CAMARA Call Forwarding Signal API, vwip - Operation retrieveUnconditio # * A device object identified by a phone number for which unconditional call forwarding service (CFS) status could not be retrieved # Background: Common call-forwarding-signal setup - Given the path "/call-forwarding-signal/vwip/unconditional-call-forwardings" + Given the path "/call-forwarding-signal/v0.4/unconditional-call-forwardings" And the header "Content-Type" is set to "application/json" And the header "Authorization" is set to a valid access token And the header "x-correlator" complies with the schema at "#/components/schemas/XCorrelator" From 4186741f113213674659f8dfeae02467a5180921 Mon Sep 17 00:00:00 2001 From: FabrizioMoggio <87469955+FabrizioMoggio@users.noreply.github.com> Date: Tue, 5 Aug 2025 09:24:07 +0200 Subject: [PATCH 3/7] 0.4.0 Public --- README.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index c36288c..9b86a50 100644 --- a/README.md +++ b/README.md @@ -27,13 +27,11 @@ 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**: Pre-release [r3.2](https://github.com/camaraproject/CallForwardingSignal/releases/tag/r3.2) with call-forwarding-signal v0.4.0-rc.1 is available. - -* The latest public release is [r2.2](https://github.com/camaraproject/CallForwardingSignal/releases/tag/r2.2) with call-forwarding-signal v0.3.0. +* The latest public release is [r3.3](https://github.com/camaraproject/CallForwardingSignal/releases/tag/r3.3) with call-forwarding-signal v0.4.0. - API definition **with inline documentation**: - - OpenAPI [YAML spec file](https://github.com/camaraproject/CallForwardingSignal/blob/r2.2/code/API_definitions/call-forwarding-signal.yaml) - - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/CallForwardingSignal/r2.2/code/API_definitions/call-forwarding-signal.yaml&nocors) - - [View it on Swagger Editor](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/CallForwardingSignal/r2.2/code/API_definitions/call-forwarding-signal.yaml) + - OpenAPI [YAML spec file](https://github.com/camaraproject/CallForwardingSignal/blob/r3.3/code/API_definitions/call-forwarding-signal.yaml) + - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/CallForwardingSignal/r3.3/code/API_definitions/call-forwarding-signal.yaml&nocors) + - [View it on Swagger Editor](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/CallForwardingSignal/r3.3/code/API_definitions/call-forwarding-signal.yaml) ## Contributing * Meetings are held virtually * Schedule: Monday 15h-16 CET, usually every two weeks. For the next meetings information, have a look on the [API Wiki Page](https://lf-camaraproject.atlassian.net/wiki/spaces/CAM/pages/14549020/CallForwardingSignal). From f8960fe3770d02383800b0ce7949a437dd492f4f Mon Sep 17 00:00:00 2001 From: FabrizioMoggio <87469955+FabrizioMoggio@users.noreply.github.com> Date: Tue, 5 Aug 2025 09:37:35 +0200 Subject: [PATCH 4/7] 0.4.0 Public RCL --- .../call-forwarding-signal-API-Readiness-Checklist.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/documentation/API_documentation/call-forwarding-signal-API-Readiness-Checklist.md b/documentation/API_documentation/call-forwarding-signal-API-Readiness-Checklist.md index 59880b0..f372f3e 100644 --- a/documentation/API_documentation/call-forwarding-signal-API-Readiness-Checklist.md +++ b/documentation/API_documentation/call-forwarding-signal-API-Readiness-Checklist.md @@ -7,16 +7,17 @@ Checklist for API call-forwarding-signal v0.4.0-rc.1 in r3.2 | Nr | API release assets | alpha | release-candidate | initial
public | stable
public | Status | Reference information | |----|----------------------------------------------|:-----:|:-----------------:|:-------:|:------:|:----:|:----| | 1 | API definition | M | M | M | M | Y | [link](/code/API_definitions/call-forwarding-signal.yaml) | -| 2 | Design guidelines from Commonalities applied | O | M | M | M | Y | [r3.2](https://github.com/camaraproject/Commonalities/releases/tag/r3.2) | -| 3 | Guidelines from ICM applied | O | M | M | M | Y | [r3.2](https://github.com/camaraproject/IdentityAndConsentManagement/releases/tag/r3.2) | -| 4 | API versioning convention applied | M | M | M | M | Y | v0.4.0-rc.1 | +| 2 | Design guidelines from Commonalities applied | O | M | M | M | Y | [r3.3](https://github.com/camaraproject/Commonalities/releases/tag/r3.3) | +| 3 | Guidelines from ICM applied | O | M | M | M | Y | [r3.3](https://github.com/camaraproject/IdentityAndConsentManagement/releases/tag/r3.3) | +| 4 | API versioning convention applied | M | M | M | M | Y | v0.4.0 | | 5 | API documentation | M | M | M | M | Y | inline in YAML | | 6 | User stories | O | O | O | M | Y | [link](/documentation/API_documentation/CFS_UserStory_UseCase-1.md) | | 7 | Basic API test cases & documentation | O | M | M | M | Y | [call-forwarding-signal-every-forwarding](/code/Test_definitions/call-forwarding-signal-every-forwarding.feature), [call-forwarding-signal-unconditional](/code/Test_definitions/call-forwarding-signal-unconditional.feature) | | 8 | Enhanced API test cases & documentation | O | O | O | M | Y | [call-forwarding-signal-every-forwarding](/code/Test_definitions/call-forwarding-signal-every-forwarding.feature), [call-forwarding-signal-unconditional](/code/Test_definitions/call-forwarding-signal-unconditional.feature) | | 9 | Test result statement | O | O | O | M | N | | -| 10 | API release numbering convention applied | M | M | M | M | Y | r3.2 | +| 10 | API release numbering convention applied | M | M | M | M | Y | r3.3 | | 11 | Change log updated | M | M | M | M | Y | [link](/CHANGELOG.md) | | 12 | Previous public-release was certified | O | O | O | M | N | | | 13 | API description (for marketing) | O | O | M | M | Y | [wiki link](https://lf-camaraproject.atlassian.net/wiki/x/uoDVB) | + From bf63ecde1d5e13b47d3dc69cd66d43d49f3505f0 Mon Sep 17 00:00:00 2001 From: FabrizioMoggio <87469955+FabrizioMoggio@users.noreply.github.com> Date: Tue, 5 Aug 2025 09:54:16 +0200 Subject: [PATCH 5/7] Update CHANGELOG.md for 0.4.0 Public --- CHANGELOG.md | 47 ++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 42 insertions(+), 5 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 1c38caf..d3c9a10 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -3,6 +3,7 @@ ## Table of Contents +- **[r3.3](#r33)** - **[r3.2](#r32)** - **[r3.1](#r31)** - **[r2.2](#r22)** @@ -20,6 +21,42 @@ The below sections record the changes for each API version in each release as fo * 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 +# r3.3 + +## Release Notes + +This release contains the definition and documentation of call-forwarding-signal v0.4.0 + +The API definition(s) are based on +* Commonalities v0.6.0 +* Identity and Consent Management v0.4.0 + +## call-forwarding-signal v0.4.0 + +This is a release candidate for the CAMARA Meta Release Fall25 release of the Call Forwarding Signal API, version v0.4.0. It contains mainly alignments with the Commonalities v0.6.0. + +- API definition **with inline documentation**: + - OpenAPI [YAML spec file](https://github.com/camaraproject/CallForwardingSignal/blob/r3.3/code/API_definitions/call-forwarding-signal.yaml) + - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/CallForwardingSignal/r3.3/code/API_definitions/call-forwarding-signal.yaml&nocors) + - [View it on Swagger Editor](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/CallForwardingSignal/r3.3/code/API_definitions/call-forwarding-signal.yaml) + +In the following there is the list of the modifications with respect to the previous release. + +### Added + +### Changed + * x-correlator new format: https://github.com/camaraproject/CallForwardingSignal/pull/180, https://github.com/camaraproject/CallForwardingSignal/pull/186 + * Undocumented Errors note in info.description: https://github.com/camaraproject/CallForwardingSignal/pull/180 + +### Fixed +* fixed some typo: https://github.com/camaraproject/CallForwardingSignal/pull/190 +* Enum Value Mismatch Between API and Tests: https://github.com/camaraproject/CallForwardingSignal/pull/190 +* +### Removed + * Removed error 401: https://github.com/camaraproject/CallForwardingSignal/pull/180 + +**Full Changelog**: https://github.com/camaraproject/CallForwardingSignal/compare/r2.2...r3.3 + # r3.2 ## Release Notes @@ -45,15 +82,14 @@ In the following there is the list of the modifications with respect to the prev ### Added ### Changed - * x-correlator new format: https://github.com/camaraproject/CallForwardingSignal/pull/180, https://github.com/camaraproject/CallForwardingSignal/pull/186 - * Undocumented Errors note in info.description: https://github.com/camaraproject/CallForwardingSignal/pull/180 ### Fixed - +* fixed some typo: https://github.com/camaraproject/CallForwardingSignal/pull/190 +* Enum Value Mismatch Between API and Tests: https://github.com/camaraproject/CallForwardingSignal/pull/190 + ### Removed - * Removed error 401: https://github.com/camaraproject/CallForwardingSignal/pull/180 -**Full Changelog**: https://github.com/camaraproject/CallForwardingSignal/compare/r2.2...r3.2 +**Full Changelog**: https://github.com/camaraproject/CallForwardingSignal/compare/r3.1...r3.2 # r3.1 @@ -273,3 +309,4 @@ The version number for the YAML file is v0.2.0-rc.1 **Full Changelog**: https://github.com/camaraproject/CallForwardingSignal/commits/r1.1 + From a23d6c5446c0e6af42801ced2495f0d44a25961b Mon Sep 17 00:00:00 2001 From: FabrizioMoggio <87469955+FabrizioMoggio@users.noreply.github.com> Date: Tue, 5 Aug 2025 15:34:49 +0200 Subject: [PATCH 6/7] Update call-forwarding-signal-API-Readiness-Checklist.md --- .../call-forwarding-signal-API-Readiness-Checklist.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/documentation/API_documentation/call-forwarding-signal-API-Readiness-Checklist.md b/documentation/API_documentation/call-forwarding-signal-API-Readiness-Checklist.md index f372f3e..63bc55a 100644 --- a/documentation/API_documentation/call-forwarding-signal-API-Readiness-Checklist.md +++ b/documentation/API_documentation/call-forwarding-signal-API-Readiness-Checklist.md @@ -1,7 +1,7 @@ # API Readiness Checklist -Checklist for API call-forwarding-signal v0.4.0-rc.1 in r3.2 +Checklist for API call-forwarding-signal v0.4.0 in r3.3 | Nr | API release assets | alpha | release-candidate | initial
public | stable
public | Status | Reference information | @@ -21,3 +21,4 @@ Checklist for API call-forwarding-signal v0.4.0-rc.1 in r3.2 | 13 | API description (for marketing) | O | O | M | M | Y | [wiki link](https://lf-camaraproject.atlassian.net/wiki/x/uoDVB) | + From 8304e9d4bb0356fbd090417bd5e5aa1a5fdbc306 Mon Sep 17 00:00:00 2001 From: FabrizioMoggio <87469955+FabrizioMoggio@users.noreply.github.com> Date: Thu, 7 Aug 2025 11:21:11 +0200 Subject: [PATCH 7/7] typo --- CHANGELOG.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index d3c9a10..887e680 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -51,7 +51,7 @@ In the following there is the list of the modifications with respect to the prev ### Fixed * fixed some typo: https://github.com/camaraproject/CallForwardingSignal/pull/190 * Enum Value Mismatch Between API and Tests: https://github.com/camaraproject/CallForwardingSignal/pull/190 -* + ### Removed * Removed error 401: https://github.com/camaraproject/CallForwardingSignal/pull/180 @@ -310,3 +310,4 @@ The version number for the YAML file is v0.2.0-rc.1 **Full Changelog**: https://github.com/camaraproject/CallForwardingSignal/commits/r1.1 +