From 78bbe01764847c8a90c82ee92a2d4af8806ca09e Mon Sep 17 00:00:00 2001
From: Chris Novakovic <chris@chrisn.me.uk>
Date: Thu, 13 Nov 2025 15:23:27 +0000
Subject: [PATCH] Tag v0.12.0-please.1

Produce releases using thought-machine/release-action rather than
softprops/action-gh-release, for consistency with the other please-build
repos, and define a version numbering format in the documentation.
---
 .github/workflows/build.yml | 14 +++-----------
 ChangeLog                   |  4 ++++
 VERSION                     |  1 +
 readme.md                   |  9 +++++++++
 4 files changed, 17 insertions(+), 11 deletions(-)
 create mode 100644 ChangeLog
 create mode 100644 VERSION

diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index 8a2f11f..e889e90 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -109,18 +109,10 @@ jobs:
       - name: Verify File Synchronization
         run: cat guest_to_host.txt | grep -q 'guest to host'
 
-      - name: Extract Version
-        id: version
-        if: startsWith(github.ref, 'refs/tags/v')
-        run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
-
       - name: Create Release
-        id: create_release
-        if: startsWith(github.ref, 'refs/tags/v')
-        uses: softprops/action-gh-release@v2
+        if: github.ref == 'refs/heads/master'
+        uses: thought-machine/release-action@master
         with:
-          name: FreeBSD ${{ steps.version.outputs.VERSION }}
-          draft: true
-          files: output/*
+          release-files: output
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
diff --git a/ChangeLog b/ChangeLog
new file mode 100644
index 0000000..f881ecb
--- /dev/null
+++ b/ChangeLog
@@ -0,0 +1,4 @@
+Version v0.12.0-please.1
+------------------------
+    * Initial release, based on upstream freebsd-builder v0.12.0
+    * Only build FreeBSD 14.3 x86-64 image (#2)
diff --git a/VERSION b/VERSION
new file mode 100644
index 0000000..723b2ce
--- /dev/null
+++ b/VERSION
@@ -0,0 +1 @@
+v0.12.0-please.1
diff --git a/readme.md b/readme.md
index 770268f..4bf5df2 100644
--- a/readme.md
+++ b/readme.md
@@ -7,3 +7,12 @@ guaranteed to be useful for any other purpose.
 ## Changes to upstream
 
 * Only the FreeBSD 14.3 x86-64 image is built.
+
+## Release version numbering
+
+Releases are versioned similarly to how they are upstream. Version numbers take the form `vX.Y.Z-please.N`, where:
+
+- `X.Y.Z` is the [upstream release](https://github.com/cross-platform-actions/freebsd-builder/releases) on which this
+  release is based;
+- `N` is a build revision specific to this repo, which is incremented each time a release is created and is reset to 1
+  whenever the repo is rebased on a newer upstream release.