Skip to content

Conversation

@Kevsy
Copy link
Contributor

@Kevsy Kevsy commented Jun 24, 2025

What type of PR is this?

Add one of the following kinds:

  • documentation

What this PR does / why we need it:

This is the first release candidate PR for SED v2.0.0 . It only includes the updates necessary for a release PR:

  • updates version numbers in YAML
  • updates CHANGELOG.MD to reflect changes since last public release

Which issue(s) this PR fixes:

Fixes #

Special notes for reviewers:

Changelog input

 release-note

Additional documentation

This section can be blank.

docs

@Kevsy Kevsy added the Fall25 label Jun 24, 2025
@Kevsy Kevsy marked this pull request as ready for review June 24, 2025 12:57
@Kevsy Kevsy requested review from a team, JoseMConde, crissancas and maheshc01 as code owners June 24, 2025 12:57
@hdamker
Copy link
Contributor

hdamker commented Jun 24, 2025

@FabrizioMoggio Great to see the release PR, I will create the release review issue. It would be good if you:

  • Touch also the checklist, versions in .feature files etc
  • Add in CHANGELOG the PRs which have solved the issues (you can omit some of them btw if they are not relevant for API Consumers)

That will make the release review easier.

@jgarciatovar
Copy link

LGTM

JoseMConde
JoseMConde previously approved these changes Jun 26, 2025
Copy link
Contributor

@JoseMConde JoseMConde left a comment

Choose a reason for hiding this comment

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

LGTM

'Changed' issues where originally under 'Added'
@Kevsy
Copy link
Contributor Author

Kevsy commented Jun 26, 2025

@FabrizioMoggio

@hdamker I guess you mean me 😁

Great to see the release PR, I will create the release review issue. It would be good if you:

  • Touch also the checklist, versions in .feature files etc

Thanks! Changed API Readiness Checklist API version, added version to Feature name

  • Add in CHANGELOG the PRs which have solved the issues (you can omit some of them btw if they are not relevant for API Consumers)

I've added them as links after the relevant issues (those which affect API consumers) but let me know if the formatting should be changed.

@hdamker
Copy link
Contributor

hdamker commented Jun 26, 2025

Thanks! Changed API Readiness Checklist API version, added version to Feature name

  • Add in CHANGELOG the PRs which have solved the issues (you can omit some of them btw if they are not relevant for API Consumers)

I've added them as links after the relevant issues (those which affect API consumers) but let me know if the formatting should be changed.

@Kevsy yep, yes I meant you ... too many comments written already.

Regarding the format: the important point is here that readers of the CHANGELOG have links to the PRs which they can easily open to see what actually was changed in the files to address the point (that also the reasons why one PR should address normally one issue/topic). There is no defined format, but most teams follow the format which is created by GitHub if you use "Generate release notes" e.g.

<PR title> by @Kevsy in https://github.com/camaraproject/SimpleEdgeDiscovery/pull/78

Normally you have to rewrite by something from the "release note" part of the PR (if provided at all). Could be also that you would list the PR multiple times if it covered several issues.

Important point here is to have the full link to the PR, not only a relative one, so that the links work as well if someone downloaded the zip file or has cloned the repository locally.

@Kevsy
Copy link
Contributor Author

Kevsy commented Jun 26, 2025

Thanks @hdamker , PR titles and absolute links now updated per format:

<PR title> by @Kevsy in https://github.com/camaraproject/SimpleEdgeDiscovery/pull/78

...and with absolute URIs.

security:
- openId:
- simple-edge-discovery:edge-cloud-zones:read
- simple-edge-discovery:read
Copy link
Contributor

@hdamker hdamker Jul 8, 2025

Choose a reason for hiding this comment

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

Just for curiosity: why this (breaking) change? (I guess both options are correct)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Just for curiosity: why this (breaking) change? (I guess both options are correct)

@hdamker changed because the Design Guide says:

"

  • api-name is the API name specified as the base path, prior to the API version, in the servers[*].url property. For example, from /location-verification/v1, it would be location-verification.

  • resource is optional. For APIs with several paths, it may include the resource in the path. For example, from /qod/v1/sessions/{sessionId}, it would be sessions."

"

Since SED has only one path, the optional resource does not apply according to the wording above. As this release is breaking anyway (because of the move from GET to POST) it seems a good time to make the scope name compliant at the same time :)

@rartych
Copy link
Contributor

rartych commented Jul 16, 2025

Typo detected in .feature file: “succesfully” → “successfully”

And the device has been succesfully identified

@Kevsy
Copy link
Contributor Author

Kevsy commented Jul 17, 2025

@rartych I updated the README to include more Release Information, at least until the template is agreed.

@rartych
Copy link
Contributor

rartych commented Jul 17, 2025

@Kevsy Please commit the accidental link removal, then we can go with the release.

@Kevsy
Copy link
Contributor Author

Kevsy commented Jul 17, 2025

@Kevsy Please commit the accidental link removal, then we can go with the release.

Thanks @rartych - Done 👍

rartych
rartych previously approved these changes Jul 18, 2025
Copy link
Contributor

@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

@Kevsy
Copy link
Contributor Author

Kevsy commented Jul 21, 2025

Thanks @rartych -
@JoseMConde now ready for Codeowner review 👍

Co-authored-by: Rafal Artych <121048129+rartych@users.noreply.github.com>
@rartych rartych requested review from JoseMConde and rartych July 22, 2025 15:00
Copy link
Contributor

@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.

Re-approved

Copy link
Contributor

@JoseMConde JoseMConde left a comment

Choose a reason for hiding this comment

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

LGTM. Re-approved.

@Kevsy Kevsy merged commit 6cd850b into main Jul 22, 2025
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants