Skip to content

docs(docs): align config/cli/metrics docs and add drift+sync automation#424

Open
mekilis wants to merge 1 commit intomainfrom
smart/docs-config-env-sync
Open

docs(docs): align config/cli/metrics docs and add drift+sync automation#424
mekilis wants to merge 1 commit intomainfrom
smart/docs-config-env-sync

Conversation

@mekilis
Copy link
Contributor

@mekilis mekilis commented Mar 25, 2026

Summary

Aligns public docs with Convoy server behavior for convoy.json, environment variables, CLI, and metrics (including cross-links and consistency between configuration and metrics pages).

PR checklist & contributor guidance

  • Adds .github/DOCUMENTATION_SYNC.md and updates the PR template so authors confirm config/env/CLI/metrics/Grafana updates (or mark N/A with a short reason).

Drift workflow (docs-drift.yml)

  • Runs on PRs that touch docs/**, drift scripts, or related .github paths.
  • Executes .github/scripts/docs-drift-check.sh: forbidden patterns under docs/ and structural consistency checks (e.g. precedence wording, shared env names across pages).

Receive workflow (convoy-docs-sync-receive.yml)

  • Listens for repository_dispatch (convoy_docs_sync) or manual workflow_dispatch with optional Convoy ref.
  • Checks out Convoy, regenerates generated docs, copies into docs/generated/convoy/, and opens/updates a sync PR via create-pull-request.

@mintlify
Copy link

mintlify bot commented Mar 25, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
convoy 🟢 Ready View Preview Mar 25, 2026, 4:52 PM

@mekilis mekilis changed the title docs(sync): align config/cli/metrics docs and add drift+sync automation docs(docs): align config/cli/metrics docs and add drift+sync automation Mar 25, 2026
@vercel
Copy link

vercel bot commented Mar 25, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
convoy-website Ready Ready Preview, Comment Mar 25, 2026 5:25pm

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant