Skip to content

docs(website): document the Cloudflare Web Analytics go-live steps - #918

Merged
tbolis-at-mulesoft merged 1 commit into
developfrom
docs/916-analytics-go-live
Oct 2, 2026
Merged

tbolis-at-mulesoft merged 1 commit into
developfrom
docs/916-analytics-go-live

Conversation

@tbolis-at-mulesoft

Copy link
Copy Markdown
Collaborator

Refs #916 (not Closes: merging to develop does not make the beacon live; #916 closes after the develop → main promotion and a live check).

Summary

  • Adds a One-time setup paragraph to the "Web analytics" section of website/README.md: register docs.donkey-kit.dev as a Web Analytics site using the manual JS snippet, copy the token from data-cf-beacon into the CF_WEB_ANALYTICS_TOKEN variable, and note that the beacon only goes live once the beacon code has reached main, the only branch that gets published.
  • Adds the devtools check (beacon.min.js loads, it reports to cloudflareinsights.com/cdn-cgi/rum, no console or CSP errors). That check was the last open acceptance criterion on Add production-only Cloudflare Web Analytics beacon to the docs site #692.
  • No code change: develop already has the beacon gate, layout wiring, and workflow env from feat(website): load Cloudflare Web Analytics beacon on production docs (#692) #695.

Test plan

  • npm test in website/: 6/6 pass.
  • npm run build with a 32-hex NEXT_PUBLIC_CF_WEB_ANALYTICS_TOKEN: the beacon renders on out/index.html and out/quickstart.html.
  • ruff check . clean; lint-imports 5 kept, 0 broken.
  • pytest / mypy: not cleanly verified locally. The borrowed venv imports the main checkout's src/, not this branch's, so 2 crewai retry tests failed, and mypy stopped on an error inside numpy's own stubs. The diff is README-only; CI on this PR is the authoritative check.

Post-deploy steps

  • CF_WEB_ANALYTICS_TOKEN repository variable: already set (2026-10-02).
  • Promote develop → main; the first docs deploy after that publishes the beacon.
  • On https://docs.donkey-kit.dev, run the devtools check above, then close Enable the Cloudflare Web Analytics beacon on docs.donkey-kit.dev #916 and comment on Donkey-Development-Kit/donkey-development-kit-metrics#21.

🤖 Generated with Claude Code

)

Name the hostname the Web Analytics site is registered for
(docs.donkey-kit.dev), where the site token comes from, and that the beacon
only goes live once the beacon code has reached main, the sole published
branch. Add the devtools check that closes #692's last acceptance criterion.

Refs #916

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@tbolis-at-mulesoft
tbolis-at-mulesoft merged commit 3f066b7 into develop Oct 2, 2026
22 checks passed
@tbolis-at-mulesoft
tbolis-at-mulesoft deleted the docs/916-analytics-go-live branch October 2, 2026 10:41
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.

Enable the Cloudflare Web Analytics beacon on docs.donkey-kit.dev

1 participant