docs: strip reader-useless implementation-leak phrasing#47
Merged
Conversation
Remove internal-plumbing framing that means nothing to a reader while preserving every reader-useful fact (price, evidence, security posture, architecture). No changes to the pinned substrate-evidence copy that the honesty guards enforce. - what-works-today: drop "backed by the configured live Stripe Product and Price"; keep the $500/month fact and the pre-payment-trial evidence. - what-works-today / hosted: "Modal session" -> "hosted browser session" (internal vendor name a reader cannot act on); all evidence retained. - hosted: replace "website retrieves the live offer server-side and Checkout confirms the same Product and Price" with the reader-facing guarantee that the website price is the price paid at Checkout. - hosted: "Live mode uses the configured ... callback secrets ..." -> "Live mode uses real ... services"; keeps the fails-closed contrast. - deployment-matrix: "Stripe Checkout using the configured product and price" -> "Stripe Checkout for the public subscription"; "The configured Stripe offer is the commercial source of truth" -> "Stripe is the commercial source of truth for pricing". - substrate-model: drop internal "provisioned by the existing oa-vm tooling"; keep the QEMU/KVM + Guacamole architecture. - deploy-on-prem / induce-a-program: replace "wired" jargon with plain "drives"/"defined by"/"configured". mkdocs build --strict, validate_docs.py, and pytest tests/ all green. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01NyCHrzA1psrKMFfroYbzaM
This was referenced Jul 21, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Sweep across all authored docs.openadapt.ai pages to remove implementation-leak / internal-plumbing phrasing that is useless to a reader, rewriting to reader-facing value. Trigger example was on
/get-started/what-works-today/:The bolded part describes our internal wiring and means nothing to a user. It now reads: "OpenAdapt Hosted has a public $500/month browser-workflow subscription."
Changes (old -> new)
openadapt-flow1.8.0" -> "A non-simulated hosted browser session onopenadapt-flow1.8.0" (internal vendor name; all evidence retained)oa-vmtooling"; kept the QEMU/KVM + Apache Guacamole architecture (reader-useful)Deliberately left as evidence, not plumbing
what-works-today.md(Windows/macOS/RDP run counts, oracle results, commit hashes, Flow PR numbers, Supported/scoped markers) enforced bytest_substrate_evidence_copy.pyandvalidate_docs.py.OPENADAPT_INGEST_TOKEN, etc.), OS-keychain resolution order,deployment.yaml, CLI--host/--tokendefaults referencing the user's configured values.security-review.mdandhosted.md, signed-webhook activation in the first-customer evidence narrative.Guards
mkdocs build --strict,python scripts/validate_docs.py, andpytest tests/(64 passed) all green.🤖 Generated with Claude Code
https://claude.ai/code/session_01NyCHrzA1psrKMFfroYbzaM