docs-deploy

What problem does it solve?

It prevents documentation changes from lingering only in the repo by providing a reliable, repeatable way to deploy and verify the live Weaverlet documentation site on weaverlet.observatoriogeo.mx.

Core Features & Use Cases

• End-to-end GitHub Pages deployment: Uses the single repository workflow (.github/workflows/docs-deploy.yml) to build and publish the docs from website/ to Pages.
• Version-aware documentation handling: Supports the Docusaurus setup that ships both next (from website/docs/) and the frozen snapshot (from website/versioned_docs/version-0.3.1/).
• Build-and-deploy verification loop: Guides you through local build validation, pushing, monitoring the workflow, and smoke-testing the deployed site for common failure modes (like trailing-slash issues).
• Standalone sync checks: Confirms whether local website changes have shipped by comparing local state, origin/main, and the latest successful workflow run.

Quick Start

Ask to deploy or redeploy the docs site for weaverlet.observatoriogeo.mx, then run the local build check and push the website/** changes on main to trigger the GitHub Actions workflow.