fix: dispatch tag-triggered docs deployments and update domain

[nobodyiam]

The tag-triggered deployment of v0.3.12 reported success while the published documentation still showed v0.3.11.

Route v* tag pushes through a small dispatcher that starts Deploy API Docs on main using workflow_dispatch, avoiding the Pages tag deployment issue. Keep automatic deployments for documentation changes on main and manual recovery. Versioned documentation continues to be built from release tags, with next built from main.

Update the README links and deployment environment URL to https://openapi.apolloconfig.com.

Validation:

• All 14 existing Python tests passed.
• Workflow YAML parsing and checks for trigger configuration, dispatch target, token permission, and deployment URL passed.
• Bash syntax validation and git diff --check passed.

The new automatic tag-to-dispatch path still needs end-to-end verification after merge.

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 85816b9c-89f9-4255-9577-8280e9c75731

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-09-22T04:30:48.313700Z	8165ffd	Draft marked ready

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

[Copilot]

Copilot review overview

🔵 Needs a closer look

The dispatcher may report success when the dispatched deployment fails or does not publish updated documentation.

Review effort: Lite
Findings: None

What changed in this PR

Routes version-tagged documentation deployments through workflow_dispatch on main and updates the public documentation domain.

Changes:

• Adds automatic tag-to-dispatch workflow.
• Preserves main and manual documentation deployments.
• Updates README links and Pages environment URL.

File	Summary
README.md	Updates documentation links and deployment guidance.
.github/​workflows/​dispatch-docs.yml	Dispatches v* tag deployments but does not verify completion.
.github/​workflows/​deploy-docs.yml	Builds from main and uses the new domain.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.