Summary

• Replace crazy-max/ghaction-github-pages with the official actions/upload-pages-artifact@v3 and actions/deploy-pages@v4
• Switch version tracking from reading gh-pages branch commit messages to using pages-deploy/<version> git tags
• Add proper permissions, concurrency, and environment configuration consistent with the already-migrated woocommerce-rest-api-docs repo

Notes

• The repository's GitHub Pages source setting must be changed from "Deploy from a branch" to "GitHub Actions" for this to work
• The first run after merging will rebuild regardless since no pages-deploy/* tags exist yet

Test plan

• Update the repo's Pages source setting to "GitHub Actions"
• Trigger a manual workflow run and verify the site deploys correctly
• Verify a pages-deploy/<version> tag is created after successful deployment
• Trigger a second run and verify it skips the build (tag already exists)

Closes QAO-31 (code-reference checkbox)

🤖 Generated with Claude Code