Website: release process

Author: dannywillems

.github/workflows/docker.yaml

@@ -122,7 +122,7 @@ jobs:
           - platform: linux/arm64
             runs-on: ubuntu-24.04-arm
     runs-on: ${{ matrix.arch.runs-on }}
-    if: github.ref == 'refs/heads/develop' || startsWith(github.ref, 'refs/tags/')
+    if: github.ref == 'refs/heads/develop' || startsWith(github.ref, 'refs/tags/') || startsWith(github.ref, 'refs/heads/release')
     steps:
       - name: Git checkout
         uses: actions/checkout@v5
@@ -144,6 +144,9 @@ jobs:
             echo "GIT_COMMIT=${GITHUB_SHA:0:8}" >> $GITHUB_ENV
           elif [[ "${{ github.ref }}" == refs/tags/* ]]; then
             echo "GIT_COMMIT=${GITHUB_REF#refs/tags/}" >> $GITHUB_ENV
+          elif [[ "${{ github.ref }}" == refs/heads/release/* ]]; then
+            BRANCH_NAME="${GITHUB_REF#refs/heads/}"
+            echo "GIT_COMMIT=${BRANCH_NAME}" >> $GITHUB_ENV
           fi
 
       - name: Build and push mina-rust image

CLAUDE.md

@@ -218,6 +218,22 @@ referencing Claude.
 6. **Verify commit message contains no emojis and follows 80-character wrap**
 7. Proceed with testing or committing changes
 
+### Documentation Script Display
+
+When adding scripts to documentation, always use Docusaurus CodeBlock imports:
+
+```mdx
+import CodeBlock from "@theme/CodeBlock";
+import ScriptName from "!!raw-loader!./path/to/script.sh";
+
+<CodeBlock language="bash" title="path/to/script.sh">
+  {ScriptName}
+</CodeBlock>
+```
+
+This ensures scripts are displayed accurately and stay in sync with the actual
+files.
+
 ### Documentation Script Testing
 
 When modifying developer setup scripts in `website/docs/developers/scripts/`,

Makefile

@@ -496,3 +496,56 @@ docs-clean: ## Clean documentation build artifacts
 	@echo "Cleaning documentation build artifacts..."
 	@rm -rf website/build website/.docusaurus website/static/api-docs target/doc
 	@echo "Documentation artifacts cleaned!"
+
+# Release management targets
+
+.PHONY: release-validate
+release-validate: ## Validate codebase is ready for release
+	@website/docs/developers/scripts/release/validate.sh
+
+.PHONY: release-update-version
+release-update-version: ## Update version in Cargo.toml files (requires VERSION=x.y.z)
+	@if [ -z "$(VERSION)" ]; then \
+		echo "Error: VERSION is required. Usage: make release-update-version VERSION=1.2.3"; \
+		exit 1; \
+	fi
+	@website/docs/developers/scripts/release/update-version.sh "$(VERSION)"
+
+.PHONY: release-docker-verify
+release-docker-verify: ## Verify multi-arch Docker images are available (requires TAG=version)
+	@if [ -z "$(TAG)" ]; then \
+		echo "Error: TAG is required. Usage: make release-docker-verify TAG=v1.2.3"; \
+		exit 1; \
+	fi
+	@DOCKER_ORG=$(DOCKER_ORG) website/docs/developers/scripts/release/verify-docker.sh "$(TAG)"
+
+.PHONY: release-create-tag
+release-create-tag: ## Create and push git tag (requires TAG=version MESSAGE="description")
+	@if [ -z "$(TAG)" ] || [ -z "$(MESSAGE)" ]; then \
+		echo "Error: TAG and MESSAGE are required."; \
+		echo "Usage: make release-create-tag TAG=v1.2.3 MESSAGE='Release v1.2.3'"; \
+		exit 1; \
+	fi
+	@website/docs/developers/scripts/release/create-tag.sh "$(TAG)" "$(MESSAGE)"
+
+.PHONY: release-merge-back
+release-merge-back: ## Merge main back to develop after release
+	@website/docs/developers/scripts/release/merge-back.sh
+
+.PHONY: release-help
+release-help: ## Show release management commands
+	@echo "Release Management Commands:"
+	@echo ""
+	@echo "  release-validate          - Validate codebase (tests, format, etc.)"
+	@echo "  release-update-version    - Update Cargo.toml versions (requires VERSION=x.y.z)"
+	@echo "  release-create-tag        - Create and push git tag (requires TAG=vx.y.z MESSAGE='...')"
+	@echo "  release-docker-verify     - Verify Docker images (requires TAG=vx.y.z)"
+	@echo "  release-merge-back        - Merge main back to develop"
+	@echo ""
+	@echo "Example workflow:"
+	@echo "  make release-validate"
+	@echo "  make release-update-version VERSION=1.2.3"
+	@echo "  # Create PR, get approval, merge to main"
+	@echo "  make release-create-tag TAG=v1.2.3 MESSAGE='Release v1.2.3'"
+	@echo "  make release-docker-verify TAG=v1.2.3"
+	@echo "  make release-merge-back"