Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add API-Readiness-Checklist.md to RM project #29

Merged
merged 10 commits into from
Jun 11, 2024
24 changes: 24 additions & 0 deletions documentation/API-Readiness-Checklist.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# API Readiness Checklist
tanjadegroot marked this conversation as resolved.
Show resolved Hide resolved

Checklist for api-name api-version in rx.y

| Nr | API release assets | alpha | release-candidate | public-release<br>initial | public-release<br> stable | Status | Comments |
|----|----------------------------------------------|:-----:|:-----------------:|:-------:|:------:|:----:|:----:|
| 1 | API definition | M | M | M | M | | |
| 2 | Design guidelines from Commonalities applied | O | M | M | M | | |
| 3 | Guidelines from ICM applied | O | M | M | M | | |
| 4 | API versioning convention applied | M | M | M | M | | |
| 5 | API documentation | M | M | M | M | | |
| 6 | User stories | O | O | O | M | | |
| 7 | Basic API test cases & documentation | O | M | M | M | | |
| 8 | Enhanced API test cases & documentation | O | O | O | M | | |
| 9 | Test result statement | O | O | O | M | | |
| 10 | API release numbering convention applied | M | M | M | M | | |
| 11 | Change log updated | M | M | M | M | | |
| 12 | Previous public-release was certified | O | O | O | M | | |
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If enhanced test plan is not required for the initial public release, and certification of the initial public release is required to have a stable public-release, this is assuming that the test plan used for the first certification is just the basic one, not the enhanced one, is this right? Or is that the initial public release has to be certified once the complete test plan is available.


To fill the checklist:
- in line above the table, replace the api-name, api-version and the rx.y by their actual values for the current API release.
- put "Y" (yes) or "N" (no) in the Status column when the release asset is available or fulfilled. You can add comments as needed.

More explanations about the release assets and criteria to be fulfilled can be found on the Release Management Wiki here [API Release Process](https://wiki.camaraproject.org/x/AgAVAQ#APIReleaseProcess-APIreadinesschecklist)