Skip to content

Clarify solo preview installation and first practice - #124

Merged
atk0309 merged 1 commit into
mainfrom
docs/first-run
Oct 2, 2026
Merged

atk0309 merged 1 commit into
mainfrom
docs/first-run

Conversation

@atk0309

@atk0309 atk0309 commented Oct 2, 2026 •

Copy link
Copy Markdown
Owner

Summary

  • Make the Windows/Linux preview guide follow download → install → five-question sample → stop/reopen → own question bank.
  • Separate full-folder backup, upgrade/recovery and uninstall instructions, preserving legacy-preview and immutable-state safety limits.
  • Put packaged-install troubleshooting first; align support, security and bug-report guidance with solo previews.
  • Simplify first-run wording and add reopening help. Clarify that Validate checks format and Review shows planned file changes, not a question-and-answer editor.
  • Record remaining consumer, accessibility and private-reporting checks.

References #119 and #121; neither issue is closed by this patch. No public release/download is claimed.

Routes touched

Copy only on / and /onboarding. No installer, authentication, provider execution, content-write or state-management logic changes.

Verification

  • Node 22.22.2 / pnpm 10.33.0 frozen offline dependency install passed.
  • Lint, typecheck, production build, formatting, pre-commit checks and 73 focused UI tests passed locally.
  • Final unblocked unit run: 1,481 tests across 86 files passed. The 17-test migration file was explicitly excluded after six tests hit this environment's tsx Unix-socket EPERM. This is not a full local green suite.
  • Local E2E could not start because the sandbox runner failed its mount setup. These local limitations remain recorded below; native CI has now passed.
  • Documentation/source review checked command names, artifact names, paths and relative links; Linux installer help and shell syntax checks passed.

Exact-head CI evidence

Head 029fe24428825535b13f8663d14cb8b1233f47fb passed on 2026-10-02:

  • Full CI: format, lint, typecheck, full unit suite, production build and E2E.
  • Solo desktop preview: Windows x64 and Linux x64 archive policy, native installation/browser acceptance and upgrade/crash checks, with preview artifact upload. Candidate assembly was correctly skipped for this PR run.

Still required

Real ordinary-user Windows/Linux browser/shortcut and download-warning checks; sample/results/resume after service restart; keyboard/screen-reader/200% zoom checks; verification of the private vulnerability-report form. Existing AI radio keyboard behavior remains deferred. CI does not establish consumer OS support or physical-power-loss durability.

Published tree cabc38b0d1f9026220c1cae1d784af69722e21b8 matches local commit 8279d49d1fa38a023a57191bdf7b5239b2d33860 exactly. Connector commit identity differs. No merge, release or tag is included.

Identical tree to locally validated 8279d49d1fa38a023a57191bdf7b5239b2d33860. References #119 and #121; consumer release gates remain open.
@coderabbitai

coderabbitai Bot commented Oct 2, 2026 •

Copy link
Copy Markdown
Contributor

Review in Change Stack →

Navigate logical layers of code changes, visualize relationships, and explore their blast radius.

Note

Currently processing new changes in this PR. This may take a few minutes, please wait...

⚙️ Run configuration

Configuration used: Repository: atk0309/project_Examify/.coderabbit.yaml

Review profile: CHILL

Plan: Team

Run ID: 68caebf9-04eb-4852-9e87-8d7f29a3ebce

📥 Commits

Reviewing files that changed from the base of the PR and between a882e59 and 029fe24.

📒 Files selected for processing (14)
  • .github/ISSUE_TEMPLATE/bug_report.yml
  • README.md
  • SECURITY.md
  • SUPPORT.md
  • docs/content-authoring.md
  • docs/release-candidate.md
  • docs/solo-installation.md
  • docs/solo-maintenance.md
  • docs/troubleshooting.md
  • src/app/onboarding/page.tsx
  • src/components/exam/ExamApp.tsx
  • src/components/exam/OnboardingWizard.tsx
  • tests/unit/exam-app-resilience-ui.test.tsx
  • tests/unit/onboarding-wizard-ui.test.tsx
 ______________________________________________________
< Your merge request walked so code reviews could run. >
 ------------------------------------------------------
  \
   \   \
        \ /\
        ( )
      .( o ).
✨ Finishing Touches
📝 Generate docstrings
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR
  • Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Autopilot is currently an internal CodeRabbit preview.


Comment @coderabbitai help to get the list of available commands.

@atk0309
atk0309 marked this pull request as ready for review October 2, 2026 18:46
@atk0309
atk0309 merged commit 65a9c57 into main Oct 2, 2026
9 of 10 checks passed
@atk0309
atk0309 deleted the docs/first-run branch October 2, 2026 18:47
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