prep for release

Author: jcbhmr

.github/workflows/draft-release.yml

@@ -10,10 +10,15 @@ jobs:
       contents: write
     runs-on: ubuntu-latest
     steps:
+      - uses: actions/checkout@v4
+      - id: get-version
+        run: |
+          version=$(cargo metadata --format-version=1 --no-deps | jq -r '.packages[0].version')
+          echo "version=$version" >> "$GITHUB_OUTPUT"
       - uses: actions/download-artifact@v4
         with:
           name: out
-      - run: gh release create '?' --draft out/*
+      - run: gh release create "$TAG" --draft out/*
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GH_REPO: ${{ github.repository }}
+          TAG: v${{ steps.get-version.outputs.version }}

README.md

@@ -38,15 +38,15 @@ console.log(greetMany(["Alan Turing", "Ada Lovelace"]));
 The easiest way to get started is by using one of these wrapper libraries that
 already have all of the WASM host imports resolved.
 
-For JavaScript users, you can use npm, [pnpm], [Yarn], or your other favorite npm package manager to install
-[`hello-world-rust-wasm-component`] from npm.
+For JavaScript users, you can use npm, [pnpm], [Yarn], or your other favorite
+npm package manager to install [`hello-world-rust-wasm-component`] from npm.
 
 ```sh
 npm install hello-world-rust-wasm-component
 ```
 
-If you prefer to customize the Javascript ↔ WASM component bindings, you can use
-[bytecodealliance/jco] to generate your own bindings.
+If you prefer to customize the Javascript ↔ WASM component bindings, you can
+use [bytecodealliance/jco] to generate your own bindings.
 
 <!-- For Python users, you can use pip, [Poetry], or another PyPI package manager to
 install [`hello-world-rust-wasm-component`] from PyPI.
@@ -82,9 +82,21 @@ For language-specific binding documentation, check out
 ./build.sh --release
 ```
 
-ℹ You'll need [`wasm-tools`] installed which you can get via `cargo install wasm-tools`.
+ℹ You'll need [`wasm-tools`] installed which you can get via
+`cargo install wasm-tools`.
 
-The `wasi_snapshot_preview1.reactor.wasm` is the adapter module to shim the component API over top of the existing WASI API. Keep it updated from [bytecodealliance/wasmtime releases]. Since this is a library we want the "reactor" version.
+The `wasi_snapshot_preview1.reactor.wasm` is the adapter module to shim the
+component API over top of the existing WASI API. Keep it updated from
+[bytecodealliance/wasmtime releases]. Since this is a library we want the
+"reactor" version.
+
+🚚 To create a new release, don't use the GitHub UI directly; use the [draft
+release] GitHub Actions workflow to create the initial draft release with the
+compiled WASM artifact. Then you can edit that release and publish it as normal.
+Make sure the `version` field is correct in `Cargo.toml` before drafting the
+release; it's used to choose the `v${version}` tag name for the release. Also
+try not to change the artifacts attached to the draft release; they were
+generated by GitHub Actions.
 
 <!-- prettier-ignore -->
 ✅ JavaScript: [jcbhmr/hello-world-rust-wasm-component/hello-world-rust-wasm-component.js](https://github.com/jcbhmr/hello-world-rust-wasm-component/tree/main/hello-world-rust-wasm-component.js) \
@@ -99,4 +111,5 @@ The `wasi_snapshot_preview1.reactor.wasm` is the adapter module to shim the comp
 [wasm component]: https://github.com/WebAssembly/component-model
 [`wasm-tools`]: https://github.com/bytecodealliance/wasm-tools
 [bytecodealliance/wasmtime releases]: https://github.com/bytecodealliance/wasmtime/releases
+[draft release]: https://github.com/jcbhmr/hello-world-wasm-component/actions/workflows/draft-release.yml
 <!-- prettier-ignore-end -->