Release 4.2

CHANGELOG.md

@@ -1,6 +1,7 @@
 # Changelog Commonalities
 
 ## Table of Contents
+- **[r4.2](#r42)**
 - **[r4.1](#r41)**
 - **[r3.4](#r34)**
 - **[r3.3](#r33)**
@@ -17,6 +18,40 @@
 - **[v0.2.0](#v020)**
 - **[v0.1.0 - Initial version](#v010---initial-version)**
 
+# r4.2
+## Release Notes
+
+This release contains documents and artifacts of Commonalities version 0.8.0-rc.2:
+* Commonalities approved deliverables in **[documentation](https://github.com/camaraproject/Commonalities/tree/r4.2/documentation)** folder.
+* Commonalities approved artifacts in **[artifacts](https://github.com/camaraproject/Commonalities/tree/r4.2/artifacts)** folder.
+**The relevant details of authentication and consent collection are covered by [release 4.2](https://github.com/camaraproject/IdentityAndConsentManagement/releases) of Identity and Consent Working Group documents.**
+
+### Added
+* Alignment with OWASP and other linting rules in CAMARA_common.yaml by @rartych in https://github.com/camaraproject/Commonalities/pull/590 and by @tlohmar in https://github.com/camaraproject/Commonalities/pull/597
+* Alignment with OWASP and other linting rules in Event subscription template by @rartych in https://github.com/camaraproject/Commonalities/pull/591
+* Added implicit-subscription API template by @hdamker in https://github.com/camaraproject/Commonalities/pull/612
+* Added pagination shared components and pagination example in sample-service-subscriptions API template by @rartych in https://github.com/camaraproject/Commonalities/pull/617
+* Testing artifacts for 400 Syntax Error including empty request body scenario by @PedroDiez in https://github.com/camaraproject/Commonalities/pull/618
+* Clarification on string `maxLength' value by @rartych in https://github.com/camaraproject/Commonalities/pull/620
+
+### Changed
+* Cloudevents decoupled from EventTypeNotification scheme in Event Subscription Template by @rartych in https://github.com/camaraproject/Commonalities/pull/604
+* CAMARA error grouping updated in CAMARA API Design Guide by @PedroDiez in https://github.com/camaraproject/Commonalities/pull/595
+* Message for Invalid Token Context Error by @PedroDiez in https://github.com/camaraproject/Commonalities/pull/607
+* Artifacts directory restructured for $ref consumption by @hdamker in https://github.com/camaraproject/Commonalities/pull/606
+* Changed response pagination guidelines by @rartych in https://github.com/camaraproject/Commonalities/pull/610 and in https://github.com/camaraproject/Commonalities/pull/617
+
+### Fixed
+* x-camara-commonalities to use full version string by @hdamker in https://github.com/camaraproject/Commonalities/pull/599
+* Commented out placeholders in CAMARA_common.yaml for $ref consumption by @hdamker in https://github.com/camaraproject/Commonalities/pull/602
+
+### Removed
+* Removed linting artifacts by @rartych in https://github.com/camaraproject/Commonalities/pull/614
+
+
+**Full Changelog**: https://github.com/camaraproject/Commonalities/compare/r4.1...r4.2
+
+
 # r4.1
 ## Release Notes
 
@@ -70,7 +105,7 @@ This release contains Commonalities version 0.6.1, a patch release from [r3.3](#
 * Changed networkAccessIdentifier and notification server example to use `example.com` by @Kevsy in https://github.com/camaraproject/Commonalities/pull/530
 
 ### Removed
-* Removed "Hashing Passwords" subsection from  CAMARA API Design Guide by @AxelNennker in https://github.com/camaraproject/Commonalities/pull/511
+* Removed "Hashing Passwords" subsection from CAMARA API Design Guide by @AxelNennker in https://github.com/camaraproject/Commonalities/pull/511
 
 **Full Changelog**: https://github.com/camaraproject/Commonalities/compare/r3.3...r3.4
 

README.md

@@ -49,7 +49,7 @@ A list of some of the frequently accessed documents that are an output of the wo
 NOTE: Guidelines for Release Management of API versions, e.g. the API-Readiness-Checklist, are located within [ReleaseManagement](https://github.com/camaraproject/ReleaseManagement). The versioning of APIs is defined within the [CAMARA API Design Guide](/documentation/CAMARA-API-Design-Guide.md#7-versioning). 
 
 ## Status and released versions
-* Release candidate of version 0.7.0 of guidelines and assets for 2026 meta-release of CAMARA APIs is available with the [r4.1 tag](https://github.com/camaraproject/Commonalities/tree/r4.1)
+* Release candidate 2 of version 0.8.0 of guidelines and assets for 2026 meta-release of CAMARA APIs is available with the [r4.2 tag](https://github.com/camaraproject/Commonalities/tree/r4.2)
 * Version 0.6.1 of guidelines and assets for Fall25 meta-release of CAMARA APIs is available with the [r3.4 tag](https://github.com/camaraproject/Commonalities/releases/tag/r3.4)
 * Previous releases and pre-releases are available in https://github.com/camaraproject/Commonalities/releases
 

VERSION.yaml

@@ -1 +1 @@
-version: 0.7.0-rc.1
+version: 0.8.0-rc.2

artifacts/api-templates/sample-implicit-events.yaml

@@ -32,7 +32,7 @@ info:
     name: Apache 2.0
     url: https://www.apache.org/licenses/LICENSE-2.0.html
   version: wip
-  x-camara-commonalities: 0.7.0
+  x-camara-commonalities: 0.8.0-rc.2
 
 externalDocs:
   description: Product documentation at CAMARA

artifacts/api-templates/sample-service-subscriptions.yaml

@@ -15,7 +15,7 @@ info:
     name: Apache 2.0
     url: https://www.apache.org/licenses/LICENSE-2.0.html
   version: wip
-  x-camara-commonalities: 0.7.0
+  x-camara-commonalities: 0.8.0-rc.2
 
 externalDocs:
   description: Product documentation at CAMARA

artifacts/api-templates/sample-service.yaml

@@ -17,7 +17,7 @@ info:
     name: Apache 2.0
     url: https://www.apache.org/licenses/LICENSE-2.0.html
   version: wip
-  x-camara-commonalities: 0.7.0
+  x-camara-commonalities: 0.8.0-rc.2
 externalDocs:
   description: Product documentation at CAMARA
   url: https://github.com/camaraproject/{apiRepository}

artifacts/common/CAMARA_common.yaml

@@ -12,7 +12,7 @@ info:
     name: Apache 2.0
     url: https://www.apache.org/licenses/LICENSE-2.0.html
   version: wip
-  x-camara-commonalities: 0.7.0
+  x-camara-commonalities: 0.8.0-rc.2
 
 components:
   securitySchemes:

artifacts/common/CAMARA_event_common.yaml

@@ -11,7 +11,7 @@ info:
     name: Apache 2.0
     url: https://www.apache.org/licenses/LICENSE-2.0.html
   version: wip
-  x-camara-commonalities: 0.7.0
+  x-camara-commonalities: 0.8.0-rc.2
 
 components:
   securitySchemes:

artifacts/notification-templates/sample-notification.yaml

@@ -11,8 +11,7 @@ info:
     name: Apache 2.0
     url: https://www.apache.org/licenses/LICENSE-2.0.html
   version: wip
-
-  x-camara-commonalities: 0.7.0
+  x-camara-commonalities: 0.8.0-rc.2
 
 externalDocs:
   description: Product documentation at CAMARA

artifacts/testing/C01-device-errors.feature

@@ -1,6 +1,6 @@
 Feature: CAMARA Common Artifact C01 - Test scenarios for device errors
 
-    CAMARA Commonalities: 0.6
+    CAMARA Commonalities: 0.8.0-rc.2
 
     Common error scenarios for operations with device as input either in the request
     body or implied from the access.

artifacts/testing/C02-phoneNumber-errors.feature

@@ -1,6 +1,6 @@
 Feature: CAMARA Common Artifact C02 - Test scenarios for phoneNumber errors
 
-    CAMARA Commonalities: 0.6
+    CAMARA Commonalities: 0.8.0-rc.2
 
     Common error scenarios for operations with phoneNumber as input either in the request
     body or implied from the access

artifacts/testing/event-subscription-template.feature

@@ -1,5 +1,7 @@
 @<xxx>
-Feature: Camara Template Subscriptions API, vwip - Operations on subscriptions
+Feature: Camara Template Subscriptions AP - Operations on subscriptions
+
+    CAMARA Commonalities: 0.8.0-rc.2
 
   # This feature file is to be used by CAMARA subproject when an event subscription resource is provided.
   # We use <xxx> as the subscription resource prefix.

artifacts/testing/syntax-errors-template.feature

@@ -1,6 +1,6 @@
 Feature: CAMARA Template Artifact 400 - Test scenarios for 400 syntax errors
 
-    CAMARA Commonalities: 0.7.0
+    CAMARA Commonalities: 0.8.0-rc.2
     Common syntax error scenarios for operations.
 
     NOTES: