From 782b1ca9e47155b4407a6329513928a2f1291620 Mon Sep 17 00:00:00 2001
From: GrantBirki <grantbirki@github.com>
Date: Thu, 2 Nov 2023 12:14:18 -0600
Subject: [PATCH 1/3] add new tag release workflow for major tags

---
 .../workflows/update-latest-release-tag.yml   | 36 +++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 .github/workflows/update-latest-release-tag.yml

diff --git a/.github/workflows/update-latest-release-tag.yml b/.github/workflows/update-latest-release-tag.yml
new file mode 100644
index 00000000..05871b90
--- /dev/null
+++ b/.github/workflows/update-latest-release-tag.yml
@@ -0,0 +1,36 @@
+name: Update Latest Release Tag
+run-name: Update ${{ github.event.inputs.major_version_tag }} with ${{ github.event.inputs.source_tag }}
+
+on:
+  workflow_dispatch:
+    inputs:
+      source_tag:
+        description: 'The tag or reference to use as the source (example: v8.0.0)'
+        required: true
+        default: vX.X.X
+      major_version_tag:
+        description: 'The major release tag to update with the source (example: v8)'
+        required: true
+        default: vX
+
+permissions:
+  contents: write
+
+jobs:
+  tag:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: git config
+        run: |
+          git config user.name github-actions
+          git config user.email github-actions@github.com
+
+      - name: tag new target
+        run: git tag -f ${{ github.event.inputs.major_version_tag }} ${{ github.event.inputs.source_tag }}
+
+      - name: push new tag
+        run: git push origin ${{ github.event.inputs.major_version_tag }} --force

From f82373b62c808b8129abb6664000634b2937f14d Mon Sep 17 00:00:00 2001
From: GrantBirki <grantbirki@github.com>
Date: Thu, 2 Nov 2023 13:28:45 -0600
Subject: [PATCH 2/3] Add maintainer guide to repository

---
 README.md                | 2 ++
 docs/maintainer-guide.md | 3 +++
 2 files changed, 5 insertions(+)
 create mode 100644 docs/maintainer-guide.md

diff --git a/README.md b/README.md
index 1b0bfe00..dc1097a3 100644
--- a/README.md
+++ b/README.md
@@ -592,3 +592,5 @@ Check out the [usage guide](docs/usage.md) for more information
 All contributions are welcome from all!
 
 Check out the [contributing guide](CONTRIBUTING.md) to learn more
+
+If you are a maintainer of this Action, please see the [maintainer guide](docs/maintainer-guide.md) for more information
diff --git a/docs/maintainer-guide.md b/docs/maintainer-guide.md
new file mode 100644
index 00000000..79cbb02b
--- /dev/null
+++ b/docs/maintainer-guide.md
@@ -0,0 +1,3 @@
+# Maintainer Guide 🧑‍🔬
+
+todo

From bcbd537087b70d8276f0b252ab1e9fe4ef6fdfba Mon Sep 17 00:00:00 2001
From: GrantBirki <grantbirki@github.com>
Date: Thu, 2 Nov 2023 13:38:01 -0600
Subject: [PATCH 3/3] add docs around the release process

---
 docs/maintainer-guide.md | 36 +++++++++++++++++++++++++++++++++++-
 1 file changed, 35 insertions(+), 1 deletion(-)

diff --git a/docs/maintainer-guide.md b/docs/maintainer-guide.md
index 79cbb02b..0970872e 100644
--- a/docs/maintainer-guide.md
+++ b/docs/maintainer-guide.md
@@ -1,3 +1,37 @@
 # Maintainer Guide 🧑‍🔬
 
-todo
+This document is intended for maintainers of the project. It describes the process of maintaining the project, including how to release new versions.
+
+## Release Process 🏷️
+
+Here is a very high level flow of how we go from idea to release:
+
+1. User XYZ wants to add feature ABC to the project
+2. The user likely opens an issue
+3. Either the user or a maintainer creates a pull request with the feature
+4. The pull request is reviewed by a maintainer - CI passing, etc
+5. The pull request is merged
+6. A new tag is pushed to the repository
+7. A pre-release is created on GitHub. Maintainers can test this pre-release and so can users.
+8. The pre-release looks good, so the maintainer(s) flip the release to a full release (aka latest)
+9. The [`update-latest-release-tag`](../.github/workflows/update-latest-release-tag.yml) workflow is run to sync major release tags with the latest release tag
+
+### Creating a Release
+
+> This project uses semantic versioning
+
+Creating a release is a rather straight forward process.
+
+Simply run the following script and follow the prompts to create, and push a new release tag:
+
+```bash
+script/release
+```
+
+Now that the new release is published you can set it as a pre-release to test it out, or set it as the latest release.
+
+Once a tag is set to the latest release, we need to update the major release tags to point to the latest release tag.
+
+_What does that mean?_... Here is an example! Let's say we just pushed a new release with the tag `v1.2.3` and we want our "major" release tag `v1` to point to this new release. We would run the [`update-latest-release-tag`](../.github/workflows/update-latest-release-tag.yml) workflow to accomplish this. The workflow has a few inputs with descriptions that will help you along with this process.
+
+The reason that we update release tags to point to major releases is for the convenience of users. If a user wants to use the latest version of this Action, all they need to do is simply point to the latest major release tag. If they point at `v1` then they will pick up **all** changes made to `v1.x.x` without having to update their workflows. When/if a `v2` tag rolls out, then they will need to update their workflows (example).