Prepare release r1.2

CHANGELOG.md

@@ -3,8 +3,54 @@
 
 ## Table of Contents
 
-- **[r1.1-rc](#r11-rc)**
 - **[r1.2-rc](#r12-rc)**
+- **[r1.1-rc](#r11-rc)**
+
+**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 each first alpha or release-candidate API version, all changes since the release of the previous public API version
+* for subsequent alpha or release-candidate API versions, the delta with respect to the previous pre-release
+* for a public API version, the consolidated changes since the release of the previous public API version
+
+# r1.2-rc
+
+## Release Notes
+
+This release contains the definition and documentation of
+* call-forwarding-signal v0.2.0-rc.2
+
+The API definition(s) are based on
+* Commonalities v0.4.0-rc.1
+* Identity and Consent Management v0.2.0-rc.2
+
+## call-forwarding-signal v0.2.0-rc.2
+
+This is the second release candidate of the version 0.2.0. It contains mainly alignments with the Commonalities 0.4.0 and the Release Management Guidelines. 
+
+The release is suitable for implementers, but it is not recommended to use the API with customers in productive environments.
+
+- API definition **with inline documentation**:
+  - OpenAPI [YAML spec file](https://github.com/camaraproject/CallForwardingSignal/blob/r1.2/code/API_definitions/Call_Forwarding_Signal.yaml)
+  - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/CallForwardingSignal/r1.2/code/API_definitions/Call_Forwarding_Signal.yaml&nocors)
+  - [View it on Swagger Editor](https://editor.swagger.io/?url=https://raw.githubusercontent.com/camaraproject/CallForwardingSignal/r1.2/code/API_definitions/Call_Forwarding_Signal.yaml)
+
+### Added
+
+### Changed
+
+* Improvement of user stories by @FabrizioMoggio in https://github.com/camaraproject/CallForwardingSignal/pull/86
+
+### Fixed
+
+* Removed the version number in the ".feature" files in the "Background" section by @FabrizioMoggiom in https://github.com/camaraproject/CallForwardingSignal/pull/83
+* Alignments within object description and fields by @FabrizioMoggio in https://github.com/camaraproject/CallForwardingSignal/pull/68
+
+### Removed
+
+
+**Full Changelog**: https://github.com/camaraproject/CallForwardingSignal/compare/r1.1...r1.2
 
 # r1.1-rc
 
@@ -19,7 +65,7 @@ The version number for the YAML file is v0.2.0-rc.1
 
 ## Please note:
 
-- This pre-release concernes a release-candidate API version, there are bug fixes to be expected and incompatible changes in upcoming versions 
+- This pre-release contains a release-candidate API version, there are bug fixes to be expected and incompatible changes in upcoming versions 
 - The release is suitable for implementers, but it is not recommended to use the API with customers in productive environments
 - Version numbers before v0.2.0-rc.1 were used during the development of this version but not released
 - The release scope is defined here: https://github.com/camaraproject/CallForwardingSignal/issues/49
@@ -40,39 +86,5 @@ The version number for the YAML file is v0.2.0-rc.1
 
 **Full Changelog**: https://github.com/camaraproject/CallForwardingSignal/commits/r1.1
 
-# r1.2-rc
-
-**This is the second pre-release of the CAMARA CallForwardingSignal API**
-
-The version number for the YAML file is v0.2.0-rc.2
-
-- API definition **with inline documentation**:
-  - OpenAPI [YAML spec file](https://github.com/camaraproject/CallForwardingSignal/blob/r1.2/code/API_definitions/Call_Forwarding_Signal.yaml)
-  - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/CallForwardingSignal/r1.2/code/API_definitions/Call_Forwarding_Signal.yaml&nocors)
-  - [View it on Swagger Editor](https://editor.swagger.io/?url=https://raw.githubusercontent.com/camaraproject/CallForwardingSignal/r1.2/code/API_definitions/Call_Forwarding_Signal.yaml)
-
-## Please note:
-
-- This pre-release concernes a release-candidate API version, there are bug fixes to be expected and incompatible changes in upcoming versions 
-- The release is suitable for implementers, but it is not recommended to use the API with customers in productive environments
-- The release scope is defined here: https://github.com/camaraproject/CallForwardingSignal/issues/72
-
-## Changes compared with [r1.1-rc](#r11-rc)
-
-* The contact field (and value) have been be removed from the OAS file: https://github.com/camaraproject/CallForwardingSignal/issues/76
-* Update of the API Readiness Checklist: https://github.com/camaraproject/CallForwardingSignal/issues/80
-* Rename of the API Readiness Checklist: https://github.com/camaraproject/CallForwardingSignal/issues/79
-* Improvement of the user stories: https://github.com/camaraproject/CallForwardingSignal/issues/81
-* Removal of the version number in the ".feature" files in the "Background" section: https://github.com/camaraproject/CallForwardingSignal/issues/77
-* Commonalities version reported in the OAS file: https://github.com/camaraproject/CallForwardingSignal/issues/66
-
-## New Contributors
-* @FabrizioMoggio
-* @bigludo7
-* @rartych
-* @StefanoFalsetto-CKHIOD
-* @enlaichu
-* @chinaunicomyangfan
 
-**Full Changelog**: https://github.com/camaraproject/CallForwardingSignal/commits/r1.2
 

code/API_definitions/Call_Forwarding_Signal.yaml

@@ -139,26 +139,24 @@ info:
     to be checked.
     # FAQ's
     (FAQs will be added in a later version of the documentation)
-  # API version - Aligned to SemVer 2.0 according to CAMARA versioning guidelines
+
   version: wip
-  # Name of the license and a URL to the license description
   license:
     name: Apache 2.0
     url: https://www.apache.org/licenses/LICENSE-2.0.html
-  # CAMARA Commonalities version - x.y.z
-  x-camara-commonalities: 0.4.0
+  x-camara-commonalities: 0.4.0-rc.2
 externalDocs:
   description: Product documentation at CAMARA
   url: https://github.com/camaraproject/CallForwardingSignal
 ############################################################################
 #                                     Servers                              #
 ############################################################################
 servers:
-  - url: "{apiRoot}/call-forwarding-signal/vwip"
+  - url: "{apiRoot}/call-forwarding-signal/v0.2.0-rc.2"
     variables:
       apiRoot:
         default: http://localhost:9091
-        description: API root for the Call Forwarding Signal API
+        description: API root, defined by the service provider, e.g. `api.example.com` or `api.example.com/somepath`
 ############################################################################
 #                                     Tags                                #
 ############################################################################

documentation/API_documentation/call-forwarding-signal-API-Readiness-Checklistst.md

@@ -5,7 +5,7 @@ Checklist for API call-forwarding-signal v0.2.0-rc.2 in r1.2
 
 
 | Nr | API release assets  | alpha | release-candidate |  public-release<br>initial | public-release<br> stable | Status | Comments |
-|----|----------------------------------------------|:-----:|:-----------------:|:-------:|:------:|:----:|:----:|
+|----|----------------------------------------------|:-----:|:-----------------:|:-------:|:------:|:----:|:----|
 |  1 | API definition                               |   M   |         M         |    M    |    M   |   Y  | /code/API_definitions/Call_Forwarding_Signal.yaml |
 |  2 | Design guidelines from Commonalities applied |   O   |         M         |    M    |    M   |   Y  |      |
 |  3 | Guidelines from ICM applied                  |   O   |         M         |    M    |    M   |   Y  |      |