-
-
Notifications
You must be signed in to change notification settings - Fork 396
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Update release procedure documentation
An internal release procedure document was created separately from the documentation hosted in this repository. That internal document became significantly more comprehensive and up to date than the unmaintained documentation in this repository. In order to avoid either the burden of maintaining two copies of the same information, or more likely the out of sync state between the information in the two resulting from lack of such maintenance, a single document will be maintained here in this repository. The superior version of the information from the internal document is hereby migrated to the repository where it will be maintained from here on.
- Loading branch information
Showing
1 changed file
with
94 additions
and
26 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,31 +1,99 @@ | ||
| # Release Procedure | ||
|
|
||
| You will not need to create a new release yourself as the Arduino team takes care of this on a regular basis, but we are documenting the process here. Let's assume the current version is `0.1.3` and you want to release `0.2.0`. | ||
| ## 🗺️ Merge localization sync PR | ||
|
|
||
| - Make sure the `main` state represents what you want to release and you're on `main`. | ||
| - Prepare a release-candidate build on a branch: | ||
| ```bash | ||
| git branch 0.2.0-rc \ | ||
| && git checkout 0.2.0-rc | ||
| ``` | ||
| - Bump up the version number. It must be a valid [semver](https://semver.org/) and must be greater than the current one: | ||
| ```bash | ||
| yarn update:version 0.2.0 | ||
| ``` | ||
| - This should generate multiple outgoing changes with the version update. | ||
| - Commit your changes and push to the remote: | ||
| ```bash | ||
| git add . \ | ||
| && git commit -s -m "Updated versions to 0.2.0" \ | ||
| && git push | ||
| A pull request titled "**Update translation files**" is submitted periodically by the "**github-actions**" bot to pull in the localization data from [**Transifex**](https://www.transifex.com/arduino-1/ide2/dashboard/). | ||
|
|
||
| If there is an open PR, this must be merged before making the release. | ||
|
|
||
| It will be shown in these search results: | ||
|
|
||
| https://github.com/arduino/arduino-ide/pulls/app%2Fgithub-actions | ||
|
|
||
| ## ⚙ Create the release on GitHub | ||
|
|
||
| First of all, you need to **set the new version in all the `package.json` files** across the app (`./package.json`, `./arduino-ide-extension/package.json`, `./browser-app/package.json`, `./electron-app/package.json`), create a PR, and merge it on the `main` branch. | ||
|
|
||
| To do so, you can make use of the `update:version` script. | ||
|
|
||
| For example, if you want to release the version `<YOUR_VERSION>`, you should run the following commands: | ||
|
|
||
| ```text | ||
| git checkout main | ||
| git pull | ||
| git checkout -b version-<YOUR_VERSION> | ||
| yarn update:version <YOUR_VERSION> | ||
| git commit -am <YOUR_VERSION> | ||
| git push origin version-<YOUR_VERSION> | ||
| ``` | ||
| - Create the GH PR the workflow starts automatically. | ||
| - Once you're happy with the RC, merge the changes to the `main`. | ||
| - Create a tag and push it: | ||
| ```bash | ||
| git tag -a 0.2.0 -m "0.2.0" \ | ||
| && git push origin 0.2.0 | ||
|
|
||
| replacing `<YOUR_VERSION>` with the version you want to release. Then create a PR and merge it. | ||
|
|
||
| Then, you need to **create and push the new tag** and wait for the release to appear on [the "**Releases**" page](https://github.com/arduino/arduino-ide/releases). | ||
|
|
||
| ⚠ Doing this will create a new release and users who already have the IDE installed will be notified from the automatic updater that a new version is available. Do not push the tag if you don't want that. | ||
|
|
||
| ```text | ||
| git checkout main | ||
| git pull | ||
| git tag -a <YOUR_VERSION> -m "<YOUR_VERSION>" | ||
| git push origin <YOUR_VERSION> | ||
| ``` | ||
| - The release build starts automatically and uploads the artifacts with the changelog to the [release page](https://github.com/arduino/arduino-ide/releases). | ||
| - If you do not want to release the `EXE` and `MSI` installers, wipe them manually. | ||
| - If you do not like the generated changelog, modify it and update the GH release. | ||
|
|
||
| Pushing a tag will trigger a **GitHub Actions** workflow on the `main` branch. Check the "**Arduino IDE**" workflow and see that everything goes right. If the workflow succeeds, a new release will be created automatically and you should see it on the ["**Releases**"](https://github.com/arduino/arduino-ide/releases) page. | ||
|
|
||
| ## 📄 Create the changelog | ||
|
|
||
| **Create GitHub issues for the known issues** that we haven't solved in the current release: | ||
|
|
||
| https://github.com/arduino/arduino-ide/issues | ||
|
|
||
| From the ["**Releases**"](https://github.com/arduino/arduino-ide/releases) page, edit the release notes following the **Keep A Changelog** scheme: | ||
|
|
||
| https://keepachangelog.com/en/1.0.0/#how | ||
|
|
||
| Add a list of mentions of GitHub users who contributed to the release in any of the following ways (ask @per1234): | ||
|
|
||
| - Submitted a PR that was merged | ||
| - Made a valuable review of a PR | ||
| - Submitted an issue that was resolved | ||
| - Provided valuable assistance with the investigation of an issue that was resolved | ||
|
|
||
| Add a "**Known Issues**" section at the bottom of the changelog. | ||
|
|
||
| ## ✎ Update the "**Software**" Page | ||
|
|
||
| Open a PR on the [bcmi-labs/wiki-content](https://github.com/bcmi-labs/wiki-content) repository to update the links and texts. | ||
|
|
||
| ℹ️ If you don't have access to the repo, ask in the `#team_wedo` **Slack** channel. | ||
|
|
||
| **❗ Make sure all the links to the new IDE build are working.**<br /> | ||
| If they aren't, there has probably been some issue with [the "**Arduino IDE**" workflow run](https://github.com/arduino/arduino-ide/actions/workflows/build.yml) triggered when pushing the tag during the "**Create the release on GitHub**" step of the release procedure. | ||
|
|
||
| Ask for a review of the PR and merge it. | ||
|
|
||
| Follow the ["**Production (subset of https://arduino.cc)**" instructions](https://github.com/bcmi-labs/wiki-content#production-subset-of-httpsarduinocc) in the `bcmi-labs/wiki-content` repository readme to deploy the updated "**Software**" page content. | ||
|
|
||
| When the deploy workflow is done, check if links on the "**Software**" page are working: | ||
|
|
||
| https://www.arduino.cc/en/software#future-version-of-the-arduino-ide | ||
|
|
||
| ## 😎 Brag about it | ||
|
|
||
| - Ask in the `#product_releases` **Slack** channel to write a post for the social media and, if needed, a blog post. | ||
| - Post a message on the forum (ask @per1234).<br /> | ||
| Example: https://forum.arduino.cc/t/arduino-ide-2-0-0-rc9-3-available-for-download/1028858/4 | ||
| - Write a message in the `#general` **Slack** channel: | ||
| > Hey **Arduino**s! Updates from the **Tooling Team** :hammer_and_wrench: | ||
| > | ||
| > Arduino IDE 2.0.0 Beta 12 is out! :doge: You can download it from the [Download Page](https://www.arduino.cc/en/software#experimental-software) | ||
| > The highlights of this release are: | ||
| > | ||
| > - auto-installation of arduino:avr at first startup | ||
| > - improvement of Serial Monitor performances | ||
| > - Arduino CLI upgrade to 0.19.1 | ||
| > - Theia upgrade to 1.18.0 | ||
| > - some bugfixing | ||
| > | ||
| > To see the details, you can take a look at the [Changelog](https://github.com/arduino/arduino-ide/releases/tag/2.0.0-beta.12) | ||
| > If you want to post about it on social media and you need more details feel free to ask us on #team_tooling! :wink: |