marketing + docs-site: production and selling review #28
Loading…
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Problem. Both surfaces grew feature-first and nobody has reviewed them end to end for production and
for selling. This is an audit issue: findings first, and code changes only for things small, safe and
obvious (typos, broken links, wrong metadata). Anything larger becomes a follow-up issue.
Review and report on:
PRODUCT.mdand the code.marketing/ordocs-site/.Also report (one paragraph, no fix) the Actions-cache failure as a pipeline issue:
::warning::Failed to restore: connect ECONNREFUSED 192.168.31.12:43873. It is the single flake signature indocs/agent-pipeline/quarantine.json(7 of 91 failing CI runs).Do not decide pricing, hosting or positioning — those are the operator's. Flag them in the DECISIONS list
with the evidence and the options, and put any unconfirmed number there too.
How to work it (the repo's own law)
issue/<N>-<slug>fromorigin/develop.main/masterare forbidden; never modify the primary checkout's working tree; commit locally and stop —the orchestrator pushes the branch and opens the PR; it never merges and neither do you.
fixes|closes|resolves #N) anywhere; useRefs #N.python3 scripts/check-ai-headers.py,python3 docs/use-cases/_check.py, and thebuild of whatever you touched (
cd marketing && bun run build,cd docs-site && bun run build).RULES.md§6.PRODUCT.mdis the operator's truth. If a doc contradicts it, the doc is wrong; if it is silent, that is adecision for the operator, not a licence to invent.
Report back with: what changed, the exact command you ran for each claim and its result, a DECISIONS list
(every judgement call), and a NOT VERIFIED list. Do not claim a build passes unless you ran it.
Claimed — branch
issue/28-production-selling-audit. Doing: end-to-end audit of marketing/ + docs-site/ (claims vs PRODUCT.md and code, copy, conversion path, links/metadata, a11y, build warnings); findings first, small safe fixes only.Moment 2 — Plan.
Refs #28Plan file:
/home/eduardez/workspace/gotoi-wt/meta/issue-28.plan.mdTask list:
middleware/src/source-presets.ts:165; only grafana/checkmk adapters definepull, pinned bymiddleware/tests/uc-mw-pull.test.ts:350-355). Files:marketing/src/lib/content/site.ts,marketing/src/lib/visuals/LoopDiagram.svelte,marketing/src/lib/sections/Integrations.svelte,marketing/src/lib/content/console-demo.ts(sources.s4pull · 30s), and its verbatim portdocs-site/lib/content.ts. Verifies with both builds +bun run test.Last:in each touched authored file; run every gate.meta/issue-28.plan.report.md+ Done comment.Out of scope (reported, not edited): deferred origin-dependent metadata (canonical/OG url,
Sitemap:line,metadataBase), and the stale "not yet supported" banners underdeploy/README.md,docs/DEPLOY*.md,docs-site/content/docs/{deploy,quickstart}.mdx— #26 residue, contradicting the 2026-10-06 operator decision. No UC: this diff adds no route/handler/page capability, so a UC would carry a fake Implementation cite.PARTIAL — audit done, one verified fix family committed.
Commit:
c118d89marketing, docs-site: Uptime Kuma is push-only, not polled(5 files, +17/−17; Refs #28). Nothing pushed.Gates (all exit 0, on
c118d89):python3 docs/use-cases/_check.py— 350 UC files, all conformpython3 scripts/check-ai-headers.py— 566 ok, 0 missingcd marketing && bun run build— ok;bun run test13/13;bun run check445 files 0 errorscd docs-site && bun run build— ok, 20 routesrg -n 'Showing lines'— zero in marketing/docs-site source (7 hits elsewhere are docs quoting the rule)Fixed (claim truthfulness): Uptime Kuma was described as polled on both surfaces; presets/providers say push-only (
source-presets.ts:165,uc-mw-pull.test.ts:350-355). Corrected integration hook, FAQ answer, loop-ingest sentence, and the console-demo sources pane. Browser-verified on both built sites, 0 console errors.Findings (no change, need your call): 37 empty screenshot placeholders across 40 built docs pages (
public/screens/only has.gitkeep); stale "cannot be self-hosted" banners indocs-site/{deploy,quickstart}.mdx+deploy/README.mdthat contradict the 2026-10-06 decision (#26 residue);PRODUCT.md:17still lists Uptime Kuma as a polled source; no canonical/OG image,sitemap.tsBASE placeholder, noSitemap:line.Full report:
/home/eduardez/workspace/gotoi-wt/meta/issue-28.plan.report.md. DECISIONS list (pricing/hosting/positioning/origin/OG/domain/#26 banners) + NOT VERIFIED list + the Actions-cache paragraph (7 of 91 runs, signatureactions-cache-unreachable) are in it.Orchestrator: branch pushed and PR open — #36 (issue/28-production-selling-audit -> agent-develop, 1 commit
c118d89). Gates re-run independently, all exit 0: check-ai-headers 566 ok, docs/use-cases/_check 350 conform, marketing build + test 13/13, docs-site build 20 routes, Showing-lines scan clean. Issue stays open — PR is for the operator/integrator to merge. DECISIONS list in the PR body + full report needs operator input (pricing, hosted tier, public origin/OG/domain, stale self-hosting banners, PRODUCT.md:17, screenshots pass).