docs: gotoi is not self-hostable — remove every claim that it is #26
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. gotoi is not self-hostable right now, and the documentation still tells readers they can
deploy it themselves. A claim the product cannot honour is the most expensive kind of documentation defect.
Where to look (not exhaustive — grep for
self-host,self host,selfhost,deploy it yourself):docs-site/content/docs/quickstart.mdxdocs-site/content/docs/deploy.mdxdocs/DEPLOY.md,docs/DEPLOY-K8S.md,docs/DEPLOY-DATABASE.mdmarketing/src/lib/content/Required change. Remove the claim, or replace it with something
PRODUCT.mdactually supports.Do not invent a replacement — no "managed cloud", no roadmap promises, no "coming soon". If the honest
replacement is nothing, the section goes.
Acceptance. (1) A grep for self-hosting language across
marketing/,docs-site/anddocs/returnsonly text that is true today. (2) Every site you changed and every site you deliberately left appears in
the report with file, wording, and why. (3)
docs-sitestill builds.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/26-docs-unsell-selfhost. Doing: finish removing self-hosting claims from the docs surfaces the prior marketing/docs pass left behind (README.md, AGENTS.md, docs/adr/003), then re-run the gates. Refs #26Plan:
/home/eduardez/workspace/gotoi-wt/meta/issue-26.plan.mdRecon: prior commits
2f81c67(marketing) +3b0f103(docs-site, deploy/, docs/DEPLOY*) already cleaned marketing/ and docs-site/. Remaining live claims are README.md (H1 + Production recipe), AGENTS.md:5, docs/adr/003:18.Tasks:
Left on purpose (reported with reasons): PRODUCT.md:17, .agents/, docs/archive|strategy|plans/, CHANGELOG.md, deploy/docker-compose.yml. Refs #26
DONE — branch
issue/26-docs-unsell-selfhost, 3 commits on top ofb5bea69, nothing pushed.Found on recon:
2f81c67(marketing) +3b0f103(docs-site, deploy/, docs/DEPLOY*) already landed the bulk;marketing/,docs-site/anddocs/DEPLOY*.mdwere already truthful. This session closed what the earlier pass left behind:6f107a6README — dropped "self-hosted" from the H1, "Production install" → "Deployment reference", added the shipped "Not yet supported" notice above the compose recipe.8c68c38AGENTS.md:5 — "a self-hosted auto-remediation system" → "an auto-remediation system".47f4e5ddocs/adr/003 — Context sentence drops "self-hosted"; header Last bumped.Gates:
python3 scripts/check-ai-headers.py→ 0 (566 ok, 0 missing, 0 malformed)python3 docs/use-cases/_check.py→ 0 (all conform)cd docs-site && bun install && bun run build→ 0 (20/20 static pages)grep -rn "Showing lines"→ only the scan references pre-existing on develop; no source hitNEEDS-DECISION flagged in the report:
PRODUCT.md:17still says "self-hosted" (the operator truth file, and the source of the claim AGENTS/README echoed) — left untouched. Also flagged:.agents/*briefs and two dateddocs/strategy/claims. Full file list (changed + deliberately left, with wording and why) and NOT VERIFIED list in/home/eduardez/workspace/gotoi-wt/meta/issue-26.report.md. Refs #26DECISION: this will be self hhostable, but not now. in the next months, so it is still true
DECISION APPLIED — commit
388a78frestores the self-hosting wording in README.md, AGENTS.md, docs/adr/003 per the operator DECISION (self-hostable in coming months; claim stays). Gates: check-ai-headers 0, docs/use-cases/_check 0, docs-site build 0 (20/20). PR: #34 (issue/26-docs-unsell-selfhost -> develop). Refs #26