Skip to content

docs: align site copy with the current CLI - #35

Merged
fullstackjam merged 3 commits into
mainfrom
docs/v1-refresh
Oct 24, 2026
Merged

fullstackjam merged 3 commits into
mainfrom
docs/v1-refresh

Conversation

@fullstackjam

@fullstackjam fullstackjam commented Sep 9, 2026 •

Copy link
Copy Markdown
Member

The site still described removed install behavior and incorrectly said that openboot update was unavailable. Align the documentation and homepage installer demo with the current released CLI, checked against v1.0.5 (bb075fbdce8dbebd51c8d2145715cbc125a0e2ad).

  • Use openboot install to start setup and describe the current preset-selection flow.
  • Document openboot update, including tap refresh on Homebrew installs, direct-binary version pins and backups, and opt-in automatic upgrades.
  • Correct install --update, doctor checks, and environment variable behavior. Pass the dry-run variable to the shell executing the installer, and clarify that OPENBOOT_DOTFILES does not override remote-config dotfiles settings.
  • Show Homebrew installation in the homepage terminal demo without a hardcoded release version.

Validation: npm run validate passed: ESLint 0 errors (223 existing warnings), Svelte checks 0 errors (4 existing warnings), 103 unit/architecture tests and 186 Workers/D1 tests passed, and production build succeeded. Staged Markdown passed Prettier and git diff --check passed. The corrected environment-variable pipeline was exercised against the v1.0.5 installer in dry-run mode; it printed the plan and exited without installing. The built docs contain the update section anchor and revised copy.

- 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!

@fullstackjam fullstackjam changed the title docs: bring site copy in line with the v1.0.0 CLI docs: align site copy with the current CLI Oct 24, 2026
@fullstackjam
fullstackjam merged commit b3f47ab into main Oct 24, 2026
7 of 8 checks passed
@fullstackjam
fullstackjam deleted the docs/v1-refresh branch October 24, 2026 14:54
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