Update release-checklist.md

Author: ThomasFarstrike

docs/other/release-checklist.md

@@ -2,51 +2,59 @@
 
 Follow these steps to create a new release of MicroPythonOS.
 
-**Update Changelog**:
-
-Document changes in `CHANGELOG.md`.
-
 **Update Version Numbers**:
 
    - Increment `CURRENT_OS_VERSION` in `internal_filesystem/lib/mpos/info.py`.
    - Update version numbers for modified apps:
 
 ```
-git diff --stat 0.0.4 internal_filesystem/  # Check changes since last release
-git diff 0.0.4 -- internal_filesystem/apps/*/META-INF/*  # Check app manifests
-git diff 0.0.4 -- internal_filesystem/builtin/apps/*/META-INF/*  # Check built-in app manifests
+git diff --stat 0.6.0 internal_filesystem/  # Check changes since last release, make sure each app change is accompanied by a META-INF/MANIFEST.json change
 ```
 
-**Commit and push** all changes, also in external repositories (e.g., [LightningPiggy](https://github.com/LightningPiggy/LightningPiggyApp)):
+**Update Changelog**:
 
-**Bundle and publish apps**:
+- Document changes in `CHANGELOG.md`
+- Run `./scripts/changelog_to_json.sh` to make sure the CHANGELOG.md is json-friendly
 
-```
-./scripts/bundle_apps.sh
-pushd ../apps/
-git add apps/
-git commit -a
-git push
-```
+**Commit and push** all changes, also in external repositories (e.g., [LightningPiggy](https://github.com/LightningPiggy/LightningPiggyApp)).
 
-**Build for all supported devices**
+This will trigger the GitHub builds at https://github.com/MicroPythonOS/MicroPythonOS/actions
 
-```
-./scripts/build_all.sh
-```
+**Download the builds**
+
+When finished, download and extract these builds as artifacts from the [GitHub actions](https://github.com/MicroPythonOS/MicroPythonOS/actions):
+
+- `MicroPythonOS_esp32_0.6.0.ota.zip`
+- `MicroPythonOS_esp32_0.6.0.bin.zip`
+- `MicroPythonOS_amd64_linux_0.6.0.elf.zip`
+- `MicroPythonOS_amd64_macOS_0.6.0.bin.zip`
+
+**Release to Over-The-Air update**
+
+- Copy `MicroPythonOS_esp32_0.6.0.ota` to the [updates repository](https://github.com/MicroPythonOS/updates) 
+- Update the `osupdate*.json` metadata files as specified in the [README.md](https://github.com/MicroPythonOS/updates/blob/main/README.md)
+
+**Release to the web installer**
+
+- Copy `MicroPythonOS_esp32_0.6.0.bin` file to the [web installer](https://github.com/MicroPythonOS/install)
+- Update the [manifest.json metadata file](https://github.com/MicroPythonOS/install/blob/master/manifests/esp32/MicroPythonOS_esp32_0.6.x.json)
+- Update `index.html` if necessary (for example, if you added a new metadata.json you need to update the 2 references)
 
 **Release to GitHub**
 
-- Upload ``` ../build_outputs/ ``` to a [new GitHub release](https://github.com/MicroPythonOS/MicroPythonOS/releases/new)
-- Add the CHANGELOG.md
-- Tag the code with the new release
+- Upload the builds a [new GitHub release](https://github.com/MicroPythonOS/MicroPythonOS/releases/new)
+- Fill in the new tag (e.g. 0.6.0)
+- Copy-paste the list from `CHANGELOG.md` in it
+- Add the "What to do" section at the bottom
 
-**Copy the builds to the [install](https://github.com/MicroPythonOS/install) and [updates](https://github.com/MicroPythonOS/updates) repositories**:
+**Bundle and publish apps**:
 
-This is a manual action, but check out these old scripts for inspiration:
 ```
-scripts/release_to_updates.sh
-scripts/release_to_install.sh
+./scripts/bundle_apps.sh
+pushd ../apps/
+git add apps/
+git commit -a
+git push
 ```
 
 ## Notes