Update build.yml to upload to the correct release and update README

Author: eregon

.github/workflows/build.yml

@@ -15,17 +15,12 @@ jobs:
     runs-on: ${{ matrix.os }}
     steps:
     - uses: actions/checkout@v4
-    - name: Set tag name
-      id: info
-      run: |
-        tag=toolcache
-        echo "tag=$tag" >> $GITHUB_OUTPUT
     - name: Set platform
       id: platform
       run: |
         platform=${{ matrix.os }}
-        platform=${platform/macos-13/macos-latest}
-        platform=${platform/macos-14/macos-13-arm64}
+        platform=${platform/macos-13/darwin-x64}
+        platform=${platform/macos-14/darwin-arm64}
         platform=${platform/%-arm/-arm64}
         echo "platform=$platform" >> $GITHUB_OUTPUT
     - name: Set ruby
@@ -36,9 +31,10 @@ jobs:
           ruby="ruby-$ruby"
         fi
         echo "ruby=$ruby" >> $GITHUB_OUTPUT
+        echo "tag=$ruby" >> $GITHUB_OUTPUT
         echo "archive=$ruby-${{ steps.platform.outputs.platform }}.tar.gz" >> $GITHUB_OUTPUT
     - name: Check if already built
-      run: '! curl -s -L --head --fail https://github.com/ruby/ruby-builder/releases/download/${{ steps.info.outputs.tag }}/${{ steps.ruby.outputs.archive }}'
+      run: '! curl -s -L --head --fail https://github.com/ruby/ruby-builder/releases/download/${{ steps.ruby.outputs.tag }}/${{ steps.ruby.outputs.archive }}'
 
     - name: Set NO_DOCUMENT
       run: |
@@ -120,7 +116,9 @@ jobs:
       env:
         GH_TOKEN: ${{ github.token }}
         GH_REPO: ${{ github.repository }}
-      run: gh release upload "toolcache" "${{ steps.ruby.outputs.archive }}"
+      run: |
+        gh release view "${{ steps.ruby.outputs.tag }}" || gh release create "${{ steps.ruby.outputs.tag }}" --notes "Builds of ${{ steps.ruby.outputs.ruby }}"
+        gh release upload "${{ steps.ruby.outputs.tag }}" "${{ steps.ruby.outputs.archive }}"
 
   buildJRubyWindows:
     if: false
@@ -132,17 +130,11 @@ jobs:
     runs-on: ${{ matrix.os }}
     steps:
     - uses: actions/checkout@v4
-    - name: Set tag name
-      id: info
-      run: |
-        tag=toolcache
-        echo "tag=$tag" >> $GITHUB_OUTPUT
-      shell: bash
     - name: Set platform
       id: platform
       run: |
         platform=${{ matrix.os }}
-        platform=${platform/windows-2022/windows-latest}
+        platform=${platform/windows-2022/windows-x64}
         platform=${platform/windows-11-arm/windows-arm64}
         echo "platform=$platform" >> $GITHUB_OUTPUT
       shell: bash
@@ -151,10 +143,11 @@ jobs:
       run: |
         ruby=jruby-${{ matrix.jruby-version }}
         echo "ruby=$ruby" >> $GITHUB_OUTPUT
+        echo "tag=$ruby" >> $GITHUB_OUTPUT
         echo "archive=$ruby-${{ steps.platform.outputs.platform }}.tar.gz" >> $GITHUB_OUTPUT
       shell: bash
     - name: Check if already built
-      run: '! curl -s -L --head --fail https://github.com/ruby/ruby-builder/releases/download/${{ steps.info.outputs.tag }}/${{ steps.ruby.outputs.archive }}'
+      run: '! curl -s -L --head --fail https://github.com/ruby/ruby-builder/releases/download/${{ steps.ruby.outputs.tag }}/${{ steps.ruby.outputs.archive }}'
       shell: bash
 
     # JAVA_HOME_21_AARCH64 - https://github.com/actions/partner-runner-images/blob/main/images/arm-windows-11-image.md#java
@@ -212,7 +205,9 @@ jobs:
       env:
         GH_TOKEN: ${{ github.token }}
         GH_REPO: ${{ github.repository }}
-      run: gh release upload "toolcache" "${{ steps.ruby.outputs.archive }}"
+      run: |
+        gh release view "${{ steps.ruby.outputs.tag }}" || gh release create "${{ steps.ruby.outputs.tag }}" --notes "Builds of ${{ steps.ruby.outputs.ruby }}"
+        gh release upload "${{ steps.ruby.outputs.tag }}" "${{ steps.ruby.outputs.archive }}"
 
 
   createPullRequest:

README.md

@@ -6,7 +6,7 @@ The action to use these prebuilt rubies is [ruby/setup-ruby](https://github.com/
 
 Please report issues to [ruby/setup-ruby](https://github.com/ruby/setup-ruby).
 
-[The latest release](https://github.com/ruby/ruby-builder/releases/latest) contains all built Rubies.
+There is one release per `$engine-$version` holding the corresponding built Rubies for the various platforms.
 
 ## Building a new Ruby release
 
@@ -27,11 +27,9 @@ Once it's ready, mark the release as non-prerelease and switch to it in `ruby/se
 ## Naming
 
 Archives are named `$engine-$version-$platform.tar.gz`.
+`$arch` is either `x64` or `arm64`
 
 `platform` is one of:
-* `ubuntu-NN.NN`: built on the corresponding GitHub-hosted runner virtual environment
-* `macos-latest`: built on `macos-13`, the oldest `macos-amd64` available on GitHub-hosted runners.
-* `macos-13-arm64`: built on `macos-14`, the oldest `macos-arm64` available on GitHub-hosted runners.
-* `windows-latest`: built on `windows-2022` (does not matter, it's only for repacking a JRuby archive, no actual build)
-
-The names contain `-latest` for compatibility, even though what `-latest` points to for runners might have changed.
+* `darwin-$arch`: built on the oldest macOS GitHub-hosted runner for that arch
+* `ubuntu-NN.NN-$arch`: built on the corresponding GitHub-hosted runner
+* `windows-$arch`: built on the oldest Windows GitHub-hosted runner for that arch