Skip to content

docs: make get-started the onboarding walkthrough - #184

Merged
abrichr merged 1 commit into
mainfrom
docs/start-alias-onboarding-2026-08-29
Aug 29, 2026
Merged

docs: make get-started the onboarding walkthrough#184
abrichr merged 1 commit into
mainfrom
docs/start-alias-onboarding-2026-08-29

Conversation

@abrichr

@abrichr abrichr commented Aug 29, 2026

Copy link
Copy Markdown
Member

docs.openadapt.ai/get-started is now the onboarding walkthrough.

It leads with the three commands (pip install, openadapt quickstart, openadapt quickstart --break-it). Then it says the bundled workflow is a tutorial. Then --break-it. Then what qualifying a real job adds (boundary, risks, identities, effect verifiers, fault cases, policy). Then the first real read-only workflow.

The hosted demo is no longer first.

docs.openadapt.ai/start/ was a 404. It is now an alias that redirects to /get-started/. Canonical stays on get-started. This is not a third product page.

The conversion page stays at openadapt.ai/start.

Tutorial VERIFIED is a local receipt on synthetic MockMed. It is not a production Seal. --break-it is the aha. When you qualify a real job, that same independent check is what a Seal attests. Links: openadapt.ai/seals and The Seal. docs/commercial/seal.md itself is not edited (ops #183 owns the screenshots).

whats-new.md is auto-generated and was left alone. A second blog post was not opened: openadapt-blog#56 already covers --break-it.

Reviewer

Open get-started. The three commands must be the first thing a reader can copy. Confirm /start/ redirects and is not in the nav.

Opened by an agent session, not the founder.

Lead get-started with pip, quickstart, and --break-it. Add a /start alias
that redirects there so a typed docs URL is not a third product page.
@abrichr
abrichr merged commit 1cff0d1 into main Aug 29, 2026
8 checks passed
@abrichr
abrichr deleted the docs/start-alias-onboarding-2026-08-29 branch August 29, 2026 21:58
@abrichr

abrichr commented Aug 29, 2026

Copy link
Copy Markdown
Member Author

Merged by an agent session, not the founder.

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