Task: Add a quickstart CLI snippet to the homepage

Table of Contents

This page documents a task in the Documentation improvements story. It captures the goal, current status, acceptance, and any notes or results.

1. Goal

An external (Gemini) UX review of the redesigned homepage suggested a short terminal quickstart/install command block for fast developer onboarding, directly on the landing page. ORE Studio has no one-line install today (it's a full C++ project built from source via compass build, no packaged installer/curl-pipe-sh script), so the first real step here is deciding what the snippet should actually show – a git clone + build sequence? A pointer to the pre-built downloads from downloads.org? Something else? – before any markup changes land.

2. Status

Field Value
State ABANDONED
Parent story Documentation improvements
Now Nothing.
Waiting on Nothing.
Next Nothing.
Last touched 2026-09-23

3. Acceptance

  • Decide and document what the snippet shows (build-from-source vs. pre-built download vs. both), matching what actually works today – don't ship a snippet implying an install path that doesn't exist.
  • A styled code block on the homepage (matching the site's existing syntax-highlighted pre.src styling) with the chosen command(s).
  • Verify the shown command(s) actually work against a fresh checkout.

4. Plan

(Implementation strategy. Written when work starts; key decisions are distilled into the parent story's * Decisions at close, but the plan itself stays — it is the historical record of what we did.)

5. Notes

6. Test Scenarios

Manual QA scenarios (scaffolded via compass add test_scenario, run through the QA Validation Runner panel) that verify this task. Link new ones here as they're created; the scenario doc itself links back via its "Verifies task" field.

Scenario State Notes
     

7. PRs

PR Title
   

8. Review

Comment summary File Decision Notes
       

9. Result

Abandoned at sprint 25 close with its open-ended parent story.

Emacs 29.3 (Org mode 9.6.15)