Add "Tour the Menu Bar" page and correct the onboarding wizard steps - #7
Add "Tour the Menu Bar" page and correct the onboarding wizard steps#7ronaldmannak wants to merge 1 commit into
Conversation
Keeps the getting-started docs in sync with changes merged in PicoServer since the last documentation run. - New page "Tour the Menu Bar" documenting the shipping menu-extra: server status + Start/Stop + address copy, the Memory bar with the GB/% legend toggle (PicoServer #37), Models in Memory (states, evict, Clear All), the Downloads section, and the actions menu. - Rewrite the onboarding step on "Install and Run" to the actual four-step wizard (Welcome, Model, Access, Ready) and drop the stale claim that onboarding sets "Open at login" and "Prevent sleep" (PicoServer #42/#48). - Wire the new page into the sidebar and adjust sidebar_position ordering. Deliberately omits the menu-extra "Inference" section (release builds keep its provider nil, so it never renders for end users) and specific model-tier names (flagged as TODO placeholders in PicoCore source).
|
Caution The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased. |
|
Noting for the record: the expected automated internal-contradiction review does not appear to be running here — This PR is intentionally self-contained but overlaps the other open documentation PRs on the onboarding paragraph — see the "Relationship to the other open documentation PRs" section in the description for the recommended consolidation (merge one onboarding PR, close #5, keep #4 independent). Generated by Claude Code |
|
Caution The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased. |
Summary
Keeps the Getting Started docs in sync with menu-bar and onboarding changes merged in
ronaldmannak/PicoServersince the last documentation run. All facts are grounded in the current source (MenuExtraView.swift,OnboardingWizardView.swift), not point-in-time PR descriptions.What changed
docs/user-guide/getting-started/tour-the-menu-bar.md). Documents the shipping menu-extra panel, which is the primary control surface:Server status(dot + label +Start/Stop+ address copy), theMemorybar (Apps/MLX/Free) with theGB/%legend toggle (PicoServer #37) and thePressureindicator,Models in Memory(statesLoading/Active/Idle, per-model evict,Clear All), theDownloadsprogress section, and the actions menu (Open Pico Web Chat,Documentation,Settings…,Setup Wizard…/Open Discordunder Option,Quit). Includes a runnable verification and troubleshooting.Welcome→ Model → Access →Ready(PicoServer #42/#48) — and removed the stale claim that onboarding setsOpen at loginandPrevent sleep; the reduced flow no longer exposes those.sidebars.ts(slot 2, matching the docs map's "Tour the Dashboard" intent) and bumpedsidebar_positiononconfigure-settings(3) andconnect-a-client(4).Evidence
Verified against
ronaldmannak/PicoServermasterat the #49 merge (9088e48):MenuExtraView.swift'sserverSection/memorySection/modelsSection/downloadsSection/actionsSectionand thememoryLegendShowsPercentGB/%toggle;OnboardingWizardView.swift'swelcome/models/access/readypages.Not done on purpose
inferenceProviderisnil, so the Inference section never renders for end users (source comment: "Release builds keep this nil so the Inference section never shows fabricated numbers"). Documenting a DEBUG-only, placeholder-data section would be inaccurate; deferred until it ships in release.Relationship to the other open documentation PRs
This routine has opened one branch/PR per run, so several overlapping doc PRs are now open against
masterand awaiting human review:install-and-runchange will conflict on that paragraph — resolve by keeping either wording (they're equivalent) and this PR's new page + sidebar entries.Recommendation for the maintainer: merge one onboarding PR (this one or #6) and close the other, close #5, and keep #4 independent — the three onboarding/menu-bar PRs should not all land.
Generated by Claude Code