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

Conversation

tanjadegroot
Copy link
Collaborator

What type of PR is this?

  • documentation

What this PR does / why we need it:

This file replaces the file in Commonalities and is updated as defined in the API release process in the Release Management Wiki Wiki (see https://wiki.camaraproject.org/display/CAM/API+Release+Process#APIReleaseProcess-APIreadinesschecklist).

Which issue(s) this PR fixes:

Fixes #28

Special notes for reviewers:

Changelog input

 Creation of updated API readiness checklist, removed from Commonalities

Additional documentation

This file replaces the file in Commonalities and is updated as defined in the API release process in the Release Management Wiki Wiki (see https://wiki.camaraproject.org/display/CAM/API+Release+Process#APIReleaseProcess-APIreadinesschecklist)
Co-authored-by: Herbert Damker <52109189+hdamker@users.noreply.github.com>
Taking into account Herbert's review comments
Updates following Herbert's comments
added column centering and api-version that got lost in translation
hdamker
hdamker previously approved these changes May 16, 2024
Copy link
Collaborator

@hdamker hdamker left a comment

Choose a reason for hiding this comment

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

LGTM - Thanks @tanjadegroot. For me it shows what we have agreed within the Release Management working group.

As this Checklist is very important for all Sub Projects I will ask today in the TSC meeting to review the PR and the linked document. So would be good to keep the PR open for about a week.

Note: comments on the document in wiki should be added there.

Copy link
Collaborator

@bigludo7 bigludo7 left a comment

Choose a reason for hiding this comment

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

Not a blocker, but, as we can understood the 4 columns as 4 steps should we add a note explaining that it is 'normal' to have initial public-release with same value than release candidate?

@tanjadegroot
Copy link
Collaborator Author

tanjadegroot commented May 16, 2024 via email

Added explanation following Ludovic's review comment
Copy link
Collaborator

@FabrizioMoggio FabrizioMoggio left a comment

Choose a reason for hiding this comment

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

Is it possible to put a link to the related documentation in the Comments column. This would improve the table also providing an overall a guide to the API development. Maybe we could first approve the table and then improve it with this links

hdamker
hdamker previously approved these changes Jun 4, 2024
| 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.

Added links in Comments column following comment from Fabrizio
@tanjadegroot
Copy link
Collaborator Author

Is it possible to put a link to the related documentation in the Comments column. This would improve the table also providing an overall a guide to the API development. Maybe we could first approve the table and then improve it with this links

Hi @FabrizioMoggio yes, in the comment column you can put what you want including link. I will add that in the documentation of the table, and have put suggestions where people could at a link

@rartych
Copy link
Collaborator

rartych commented Jun 6, 2024

Is it possible to put a link to the related documentation in the Comments column. This would improve the table also providing an overall a guide to the API development. Maybe we could first approve the table and then improve it with this links

@tanjadegroot I think Fabrizio wanted to add links to guidelines/templates of specific assets, but providing the links to artifacts related to given API version is good idea for me.
@FabrizioMoggio The related documentation for different assets is linked in the Explanations table in the Wiki: https://wiki.camaraproject.org/display/CAM/API+Release+Process#APIReleaseProcess-APIreadinesschecklist

Copy link
Collaborator

@rartych rartych left a comment

Choose a reason for hiding this comment

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

LGTM

@tanjadegroot
Copy link
Collaborator Author

tanjadegroot commented Jun 6, 2024

Is it possible to put a link to the related documentation in the Comments column. This would improve the table also providing an overall a guide to the API development. Maybe we could first approve the table and then improve it with this links

@tanjadegroot I think Fabrizio wanted to add links to guidelines/templates of specific assets, but providing the links to artifacts related to given API version is good idea for me. @FabrizioMoggio The related documentation for different assets is linked in the Explanations table in the Wiki: https://wiki.camaraproject.org/display/CAM/API+Release+Process#APIReleaseProcess-APIreadinesschecklist

The link is already there in the last line of the file. I changed the text and the name of the link to be more explicit.

clarified documentation link
@tanjadegroot
Copy link
Collaborator Author

@soadeyemo Hi Samuel, can you please review and approve the PR ?

soadeyemo
soadeyemo previously approved these changes Jun 6, 2024
Copy link
Collaborator

@soadeyemo soadeyemo left a comment

Choose a reason for hiding this comment

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

Reviewed and Approved.

updated text on Status and Comments column
@tanjadegroot
Copy link
Collaborator Author

@soadeyemo - Hi Samuel, sorry, but can you review and approve again please, I fixed some typos and explanations in the checklist.

Copy link
Collaborator

@soadeyemo soadeyemo left a comment

Choose a reason for hiding this comment

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

Reviewed and approved.

@soadeyemo soadeyemo merged commit f94ae58 into camaraproject:main Jun 11, 2024
@tanjadegroot tanjadegroot deleted the New-checklist-upload branch July 26, 2024 11:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add new API readiness checklist
7 participants