Skip to content

docs: bring site copy in line with the v1.0.0 CLI - #35

Open
fullstackjam wants to merge 1 commit into
mainfrom
docs/v1-refresh
Open

docs: bring site copy in line with the v1.0.0 CLI#35
fullstackjam wants to merge 1 commit into
mainfrom
docs/v1-refresh

Conversation

@fullstackjam

Copy link
Copy Markdown
Member

What was stale

The site was last touched on Jul 18, before v1.0.0 (Aug 2). Audited every page under src/docs/ and the landing page against the v1.0.0 binary (openboot <cmd> --help), scripts/install.sh, and the Go source.

  • Landing page mock terminal showed a hardcoded Downloading OpenBoot v0.44.0... direct-download flow. install.sh installs through Homebrew now; the mock mirrors its real output and no longer carries a version string.
  • cli-reference: openboot update was listed as removed in v1.0. It exists (brew upgrade wrapper on Homebrew installs; --version / --rollback / --list-backups on direct installs, per internal/cli/update.go). Added it to the command list and replaced the "no self-update command" section. Also fixed --update (it updates Homebrew and exits, it does not install) and two doctor rows: the state check looks at sync_source.json / state.json, not install_state.json; the PATH check is /opt/homebrew/bin on Apple Silicon only.
  • faq: dropped the claim that openboot update --self was removed.
  • env-vars: OPENBOOT_VERSION is assigned on line 4 of install.sh and never read; removed the row. Added OPENBOOT_DOTFILES, OPENBOOT_DISABLE_AUTOUPDATE, OPENBOOT_API_URL, which the CLI reads but the page (which claims to be exhaustive) omitted.
  • quick-start / what-is-openboot: bare openboot prints help (root command has no Run); the wizard is openboot install. Presets never become a sync source (SyncSource is user/slug only), so "(or a preset)" is gone.

Verification

  • npm run validate: eslint 0 errors (223 pre-existing warnings), svelte-check 0 errors, vitest 103 + 186 passed, build OK.
  • Built output: 0 occurrences of v0.44.0, docs chunk contains the new openboot update section.
  • Dev server with local D1 migrations: /, /docs/cli-reference, /docs/quick-start, /docs/env-vars, /docs/faq, /docs/what-is-openboot all 200; landing hero and cli-reference screenshots checked.
  • prettier --check src/routes/+page.svelte fails identically on main (JSON-LD block in <svelte:head>), not introduced here.

- Landing page mock terminal showed a hardcoded 'Downloading OpenBoot
  v0.44.0' direct-download flow; install.sh now installs through
  Homebrew, so mirror its actual output and drop the version string.
- cli-reference: 'openboot update' still exists in v1.0 (brew upgrade
  wrapper on Homebrew installs, pin/rollback on direct installs); it
  was wrongly listed as removed. Fix the --update flag meaning (update
  Homebrew and exit) and the doctor table (state file and PATH checks).
- faq: drop the claim that 'update --self' was removed.
- env-vars: OPENBOOT_VERSION is a dead variable in install.sh; add
  OPENBOOT_DOTFILES, OPENBOOT_DISABLE_AUTOUPDATE, OPENBOOT_API_URL
  which the CLI reads but the page omitted.
- quick-start / what-is-openboot: bare 'openboot' prints help; the
  wizard is 'openboot install'. Presets never become a sync source.
@codecov

codecov Bot commented Sep 9, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

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