diff --git a/documentation/API_documentation/home-devices-qod-API-Readiness-Checklist.md b/documentation/API_documentation/home-devices-qod-API-Readiness-Checklist.md new file mode 100644 index 0000000..5c3be06 --- /dev/null +++ b/documentation/API_documentation/home-devices-qod-API-Readiness-Checklist.md @@ -0,0 +1,27 @@ +# API Readiness Checklist + +Checklist for home-devices-qod 0.4.0-rc.1 in r1.1 + +| Nr | API release assets | alpha | release-candidate | initial
public | stable
public | Status | Comments | +|----|----------------------------------------------|:-----:|:-----------------:|:-------:|:------:|:----:|----| +| 1 | API definition | M | M | M | M | Y | [home_devices_qod.yaml](/code/API_definitions/home_devices_qod.yaml) | +| 2 | Design guidelines from Commonalities applied | O | M | M | M | Y | | +| 3 | Guidelines from ICM applied | O | M | M | M | Y | | +| 4 | API versioning convention applied | M | M | M | M | Y | | +| 5 | API documentation | M | M | M | M | Y | Embedded in [API definition](/code/API_definitions/home_devices_qod.yaml) | +| 6 | User stories | O | O | O | M | Y | [home_devices_qod_user_stories.md](/documentation/API_documentation/home_devices_qod_user_stories.md) | +| 7 | Basic API test cases & documentation | O | M | M | M | Y | [home-devices-qod.feature](/code/Test_definitions/home-devices-qod.feature) | +| 8 | Enhanced API test cases & documentation | O | O | O | M | Y | [home-devices-qod.feature](/code/Test_definitions/home-devices-qod.feature) | +| 9 | Test result statement | O | O | O | M | N | | +| 10 | API release numbering convention applied | M | M | M | M | Y | | +| 11 | Change log updated | M | M | M | M | Y | [CHANGELOG.md](/CHANGELOG.md) | +| 12 | Previous public release was certified | O | O | O | M | | | + +To fill the checklist: +- in the line above the table, replace the api-name, api-version and the rx.y by their actual values for the current API version and release. +- in the Status column, put "Y" (yes) if the release asset is available or fulfilled in the current release, a "N" (no) or a "tbd". Example use of "tbd" is in case an alpha or release-candidate API version does not yet provide all mandatory assets for the release. +- in the Comments column, provide the link to the asset once available, and any other relevant comments. + +Note: the checklists of a public API version and of its preceding release-candidate API version can be the same. + +The documentation for the content of the checklist is here: [API Readiness Checklist](https://wiki.camaraproject.org/x/HQBFAQ) \ No newline at end of file diff --git a/documentation/API_documentation/home_devices_qod_readiness_checklist.md b/documentation/API_documentation/home_devices_qod_readiness_checklist.md deleted file mode 100644 index 27fc16b..0000000 --- a/documentation/API_documentation/home_devices_qod_readiness_checklist.md +++ /dev/null @@ -1,27 +0,0 @@ -# HomeDevicesQoD API Readiness minimum criteria checklist - -Checklist template in Commonalities: [API Readiness minimum criteria checklist](https://github.com/camaraproject/WorkingGroups/blob/main/Commonalities/documentation/API-Readiness-Checklist.md) - -
- -| No | Deliverables/Criteria | Mandatory | Status (*) | Resolution | -|----|----------------------------------|-----------|----------------------------|----------------------------| -| 1 |API Spec | Y | Approved | [x] Done | -| 2 |API Implementation | N | | | -| 3 |API Documentation | Y | Approved | [x] Done | -| 4 |User Stories | Y | Approved | [x] Done | -| 5 |API test cases | Y | Contributed | [ ] Not completed yet | -| 6 |Validated by at least 2 operators | Y | Pending | [ ] Not completed yet | -| 7 |Security review | Y | Approved | [x] Done | - -(*) Status: (Contributed/Approved/Pending/Validated/Partly-Validated) - -
- - 1. API Spec: [HomeDevicesQoD API Spec](https://github.com/camaraproject/HomeDevicesQoD/blob/main/code/API_definitions/home_devices_qod.yaml) - 2. API Implementation: N/A - 3. API Documentation: Embedded in the API Spec. - 4. User Stories: [HomeDevicesQoD User Stories](https://github.com/camaraproject/HomeDevicesQoD/blob/main/documentation/API_documentation/home_devices_qod_user_stories.md). - 5. API test cases: Contributed but not approved yet. - 6. Validated by at least 2 operators: TBC - 7. Security review: API spec includes a security scheme section that complies with the AuthN&AuthZ techniques agreed in Commonalities.