Publish releases automatically when a version tag is pushed

.github/workflows/release.yml

@@ -61,15 +61,14 @@ jobs:
           MAVEN_CENTRAL_PASSWORD: ${{ secrets.MAVEN_CENTRAL_PASSWORD }}
           MAVEN_GPG_PASSPHRASE: ${{ secrets.GPG_PASSPHRASE }}
 
-      # A draft: the Central deployment is published by hand, so the
-      # release is published once the artifacts are live
-      - name: Create GitHub draft release
+      # The deploy step waits until Central has published the artifacts, so
+      # the release goes out once they are live
+      - name: Create GitHub release
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           gh release create "$GITHUB_REF_NAME" \
             --repo "$GITHUB_REPOSITORY" \
-            --draft \
             --verify-tag \
             --title "${GITHUB_REF_NAME#v}" \
             --generate-notes

README.md

@@ -745,14 +745,18 @@ automatic `OPTIONS`.
 1. Set the release version in `pom.xml` (remove `-SNAPSHOT`) and merge it to `master` via PR
 2. Tag the merged commit on `master` and push the tag:
    ```sh
-   git tag v5.0.0
-   git push origin v5.0.0
+   git tag v5.1.0
+   git push origin v5.1.0
    ```
 3. The Release workflow checks that the tag matches the `pom.xml` version and is on
-   `master`, uploads the signed artifacts to Maven Central, and creates a
-   **draft** GitHub release
-4. Publish the deployment at https://central.sonatype.com/publishing/deployments
-5. Once the artifacts are live on Central, publish the draft release on GitHub
+   `master`, uploads the signed artifacts to Maven Central, waits until Central
+   has published them, and then publishes the GitHub release with generated notes
+
+Pushing the tag is the point of no return: Central releases cannot be withdrawn
+or replaced. Run the bundle dry run below first if in doubt. If the workflow
+fails after Central has published (for example, the one-hour wait runs out),
+create the GitHub release by hand with
+`gh release create vX.Y.Z --verify-tag --title X.Y.Z --generate-notes`.
 
 The workflow uses the `MAVEN_CENTRAL_USERNAME`, `MAVEN_CENTRAL_PASSWORD`,
 `GPG_PRIVATE_KEY` and `GPG_PASSPHRASE` repository secrets; the passphrase

pom.xml

@@ -146,6 +146,10 @@
             <extensions>true</extensions>
             <configuration>
               <publishingServerId>central</publishingServerId>
+              <!-- A pushed tag publishes the release: no manual step on Central -->
+              <autoPublish>true</autoPublish>
+              <waitUntil>published</waitUntil>
+              <waitMaxTime>3600</waitMaxTime>
             </configuration>
           </plugin>
         </plugins>