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

Clarify version handling for workspaces in ReleaseGuide #12020

Merged
merged 2 commits into from
Jun 6, 2024
Merged

Conversation

jjhembd
Copy link
Contributor

@jjhembd jjhembd commented Jun 4, 2024

Description

This PR is a simple clarification for one item in the ReleaseGuide.

During a release, we update versions for each workspace according to semantic versioning, based on the changes in CHANGES.md. However, if CHANGES.md only lists changes in @cesium/engine, we still need to update the version for @cesium/widgets to reflect the update in its dependencies.

If the dependent workspace version is not updated, the top-level cesium and @cesium/widgets will be pointing to different versions of @cesium/engine. This version conflict can cause build problems for some users.

Testing plan

N/A

Author checklist

  • I have submitted a Contributor License Agreement
  • I have added my name to CONTRIBUTORS.md
    [ ] I have updated CHANGES.md with a short summary of my change
    [ ] I have added or updated unit tests to ensure consistent code coverage
    [ ] I have update the inline documentation, and included code examples where relevant
  • I have performed a self-review of my code
Copy link

github-actions bot commented Jun 4, 2024

Thank you for the pull request, @jjhembd!

✅ We can confirm we have a CLA on file for you.

@@ -24,8 +24,9 @@ There is no release manager; instead, our community shares the responsibility. A
6. Update the Cesium ion demo token in `Ion.js` with a new token from the CesiumJS ion team account with read and geocode permissions. These tokens are named like this: `1.85 Release - Delete on November 1st, 2021`. Delete the token from 2 releases ago.
7. Update the ArcGIS Developer API key in `ArcGisMapService.js` with a new API key from the CesiumJS ArcGIS Developer account. These API keys are named like this: `1.85 Release - Delete on November 1st, 2021`. Delete the API key from the last release.
8. Proofread [`CHANGES.md`](../../../CHANGES.md) with the date of the release. Adjust the order of changes so that prominent/popular changes come first. Ensure each change is in the section for the relevant workspace.
9. Based on `CHANGES.md`, update each workspace version following the rules of [semantic versioning](https://semver.org/), e.g.,
- `npm version minor -w @cesium/engine --no-git-tag-version`
9. Based on `CHANGES.md`, update each workspace version following the rules of [semantic versioning](https://semver.org/), e.g.,
Copy link
Contributor

Choose a reason for hiding this comment

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

I might also suggest charging the publishing order so that cesium is published after the individual workspaces. That way, we would catch the error with time to change it.

@jjhembd
Copy link
Contributor Author

jjhembd commented Jun 6, 2024

Thanks for the suggestion @ggetz! I think this is ready to go now.

@ggetz
Copy link
Contributor

ggetz commented Jun 6, 2024

Looks good! Thanks @jjhembd!

@ggetz ggetz merged commit e699d14 into main Jun 6, 2024
9 checks passed
@ggetz ggetz deleted the version-note branch June 6, 2024 19:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
2 participants