docs: improve search retrievability for key pages

[diberry]

Context

The semantic search TF-IDF ranking (PR #64) works with existing content. Some pages could be improved to surface better in search results.

Suggested improvements

• model-selection.md: Add 'model pinning' as an alias/synonym in the heading or intro — users search for 'pin model' but the page uses 'persistent preferences'
• reference/api: Add manual search index entry (generated page, not markdown)
• General: Review top pages for synonym coverage per Flight's retrievability scoring framework (PRD: SQLite vector search for docs chat — feasibility and architecture #40 comments)

Approach

• Use FIDO's 45-query catalog (posted on PRD: SQLite vector search for docs chat — feasibility and architecture #40) to identify which pages score low
• Add natural synonyms/aliases to page headings and intros
• Do NOT change content purely for SEO — terms must be accurate

Related

• PRD: SQLite vector search for docs chat — feasibility and architecture #40 (semantic search MVP)
• Retrievability scoring design (Flight's comment on PRD: SQLite vector search for docs chat — feasibility and architecture #40)
• Query catalog (FIDO's comment on PRD: SQLite vector search for docs chat — feasibility and architecture #40)

[github-actions]

📋 Assigned to DSKY (TUI Engineer)

Issue: #66 — docs: improve search retrievability for key pages

DSKY will pick this up in the next Copilot session.

For Copilot coding agent: If enabled, this issue will be worked automatically.
Otherwise, start a Copilot session and say:
DSKY, work on issue #66

[github-actions]

🏗️ Squad Triage — Flight (Lead)

Issue: #66 — docs: improve search retrievability for key pages
Assigned to: FIDO (Quality Owner)
Reason: Issue relates to testing/quality work

@copilot evaluation: 🔴 Not suitable — issue involves work outside the coding agent's capability profile.

Team roster:

• Flight (Lead) → label: squad:flight
• Procedures (Prompt Engineer) → label: squad:procedures
• EECOM (Core Dev) → label: squad:eecom
• FIDO (Quality Owner) → label: squad:fido
• PAO (DevRel) → label: squad:pao
• CAPCOM (SDK Expert) → label: squad:capcom
• CONTROL (TypeScript Engineer) → label: squad:control
• Surgeon (Release Manager) → label: squad:surgeon
• Booster (CI/CD Engineer) → label: squad:booster
• GNC (Node.js Runtime) → label: squad:gnc
• Network (Distribution) → label: squad:network
• RETRO (Security) → label: squad:retro
• INCO (CLI UX & Visual Design) → label: squad:inco
• GUIDO (VS Code Extension) → label: squad:guido
• Telemetry (Aspire & Observability) → label: squad:telemetry
• VOX (REPL & Interactive Shell) → label: squad:vox
• DSKY (TUI Engineer) → label: squad:dsky
• Sims (E2E Test Engineer) → label: squad:sims
• Handbook (SDK Usability) → label: squad:handbook
• Ralph (Work Monitor) → label: squad:ralph
• @copilot (Coding Agent) → label: squad:copilot

To reassign, remove the current squad:* label and add the correct one.

[diberry]

Closing: work completed upstream or no longer relevant. See diberry/project-dina#22 cleanup audit.