chore(ci): Automate documentation release pipeline

[dishaprakash]

Automates the manual release pipeline of updating Hugo version dropdown configurations during the release process.

Background

Currently, when a new release is prepared (via a release-please PR), a maintainer has to manually edit .hugo/hugo.cloudflare.toml to add the new version block and prune the oldest version from the Cloudflare configuration. This PR introduces a automation pipeline to handle this seamlessly.

Changes

1. Automation Script ([.ci/update_docs_versions.py]):
   • A lightweight, idempotent Python script that reads the new version (either passed as a command-line argument or read from cmd/version.txt).
   • Inserts the new version block in the TOML file right after the version list comment marker while fully preserving existing comments, spacing, and formatting.
   • For hugo.cloudflare.toml, it automatically prunes the oldest version, keeping the list capped at exactly 8 versions (dev + the 7 most recent releases).
2. GitHub Actions Workflow ([.github/workflows/update_release_docs_config.yml]):
   • Supports a hybrid trigger:
     • Automated Mode: Automatically runs on PRs opened/updated by release-please and commits/pushes the version updates directly back into the release PR branch.
     • Manual Mode (workflow_dispatch): Allows maintainers to run the workflow manually on any branch (e.g. main or a release branch) with an optional version input.

[gemini-code-assist]

Code Review

This pull request introduces a Python script .ci/update_docs_versions.py to automate updating documentation versions in the Hugo configuration file (hugo.cloudflare.toml). The script inserts new version blocks and prunes older ones to keep a maximum of eight versions. The review feedback recommends improving the robustness of the regular expressions used: first, by escaping the version string to prevent dots from being treated as wildcards, and second, by using a more flexible pattern to match the version blocks regardless of field order or formatting.

[averikitsch]

We can't use the Github action bot to commit changes since it can not sign the CLA (go/cla). @twishabansal has a solution to update the release please PR using that identity

[dishaprakash]

Updated to release please bot, similar to https://github.com/gemini-cli-extensions/cloud-sql-postgresql/blob/38ab73d23d58342ea046d1163ddc9f1a83d13303/.github/workflows/skills-generate.yml#L52