Skip to content

Docs accuracy pass: fix contradictions and align with bot/realtime source#94

Merged
styler merged 4 commits into
masterfrom
seo-correctness-fixes
Jul 18, 2026
Merged

Docs accuracy pass: fix contradictions and align with bot/realtime source#94
styler merged 4 commits into
masterfrom
seo-correctness-fixes

Conversation

@styler

@styler styler commented Jul 18, 2026

Copy link
Copy Markdown
Member

Part 1 of 3 of the SEO/content review (merge first).

Every claim here was verified against the actual source: chatbot, astro, pogu/caipirinha (via astro topics), and the dashboard frontend i18n/nav.

Internally-provable fixes

  • Widget events: button-click example read listener from the wrong path (obj.detail.event.listener — never fires); prose said apiKey where the property is apiToken.
  • AlertBox exit animation: {{widgetDuration}} is seconds; the JS treated it as ms, producing a negative timeout that fired instantly.
  • Raffles: cancelraffle/commands-index described a points-entry/keyword-entry model that doesn't exist — real distinction is multi-winner (split pot) vs single-winner; entry is always free via !join.
  • !giveaway was described as a start/manage command; it only checks status.
  • Dead legacy link docs.streamelements.com/docs/loyalty/overview (404s live) → support KB article + verified dashboard path.
  • Mixed $(1)/${1} in the copy-paste shoutout example; $("container") selector missing #.

Source-verified corrections

  • channel.session.reset payload is flat under data (not data.session) — pogu sessions/middleware.ts. Fixed the table, the example, and all client examples on the examples page. Session keys are <type>-latest (follower-latest, not latest-follower/latest_follower).
  • channel.session.update full payload documented (key/name/data/provider/channel).
  • Contests: ended marked legacy (never emitted); running → completed direct transition and refund-from-any-state added to the diagram (caipirinha contests/index.ts).
  • Roulette pays even money and the slider is win chance (docs had it inverted vs the dashboard's "% chance to win" label); Slotmachine only pays 3-of-a-kind, exact payout formula documented (bet × emotes² × return%).
  • Spam filters: One-Man Spam, Repetition, Zalgo, Language now document their real settings (source structs + dashboard dialog labels). Repetition filters repeated words, not characters.
  • !raffle/!sraffle args are optional with verified defaults (5000/1000 pts, module duration, 5s min, 1M cap); %/all don't work for raffle amounts.
  • Permission levels: -level accepts exactly 100/250/300/400/500/1000 (core.ValidLevels); removed the bogus 2000: Broadcaster.
  • Trovo is retired (chatbot commit "remove Trovo support — platform has shut down"): removed from 30 pages' badges/prose, the schema enum (now a build error), and PlatformBadges. Per-command platform lists aligned with the audited masks (settitle/setgame/permit = Twitch+Kick; vanish/uptime = Twitch+YouTube; etc.).
  • Chatbot getting-started now actually builds the promised "last seen" command ($(user.lastseen)) with expected output.
  • Weather "updated every 10-15 minutes" claim removed (bot fetches per call; no such cache in source).

Notes for reviewers

  • The Language filter has no dashboard UI in the current frontend (every other filter has dialog i18n; language has none) — the page now describes behavior without pointing at a dialog. Worth confirming with support where/whether it's configurable.
  • LoL (name-first) vs TFT (region-first) opposite argument orders are confirmed correct in source — added a cross-reference note instead of "fixing" them.
  • Includes a docs changelog entry for the accuracy pass.

🤖 Generated with Claude Code

styler added 3 commits July 18, 2026 13:41
…box ms math, raffle semantics, !giveaway description, argument token syntax, dead loyalty link
…ontest states, roulette/slots payouts, filter settings, raffle defaults
…vo, fix permission levels, complete getting-started walkthrough
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jul 18, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Updated (UTC)
✅ Deployment successful!
View logs
docs 1ed6688 Jul 18 2026, 03:02 PM

@styler
styler merged commit c9f3c23 into master Jul 18, 2026
2 checks passed
@styler
styler deleted the seo-correctness-fixes branch July 18, 2026 15:11
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