Skip to main content

​
Deployment Runbook: Publish docs.clawcontrol.cc

This runbook prepares and publishes this Mintlify site under the custom domain.

​
1. Validate Docs Locally

cd mintlify
npm install
npm run validate
npm run links
npm run a11y
Fix all validation/link issues before publishing.

​
2. Connect Repo + Project in Mintlify

  1. Open Mintlify dashboard.
  2. Select the docs project connected to this repository.
  3. Confirm docs root points to mintlify/.

​
3. Add Custom Domain

In Mintlify project settings, add docs.clawcontrol.cc. Mintlify will provide required DNS records. Copy exact values from dashboard. Required placeholders to replace from dashboard:
  • <MINTLIFY_DNS_TYPE_FROM_DASHBOARD>
  • <MINTLIFY_HOST_FROM_DASHBOARD>
  • <MINTLIFY_TARGET_FROM_DASHBOARD>
  • <MINTLIFY_TXT_NAME_FROM_DASHBOARD>
  • <MINTLIFY_TXT_VALUE_FROM_DASHBOARD>

​
4. Configure DNS

Create records in authoritative DNS zone for clawcontrol.cc using the exact Mintlify-provided values. Do not guess target values.

​
5. Verify Propagation

dig docs.clawcontrol.cc
Confirm response matches Mintlify record target/verification values.

​
6. TLS Verification Checklist

  • https://docs.clawcontrol.cc loads successfully
  • certificate is valid and unexpired
  • certificate SAN includes docs.clawcontrol.cc
  • no browser TLS warnings
  • no mixed-content errors in page console/network

​
7. Final Smoke Checks

  • homepage loads
  • sidebar navigation is complete
  • key pages render (/product/architecture, /api/overview, /operations/troubleshooting)

​
Last updated

2026-02-09