CodeNomad/docs/help
Pascal André 339ecf945c
feat(help): open localized guide sections from contextual info icons (#1404)
## Summary

- Extend the existing `SettingsInfoTip` with `help?: { page: string;
anchor?: string }`; retain short hover/focus explanations and open
matching localized help externally on click, Enter or touch.
- Reuse `helpUrl` and `openExternalUrl`, guard page/anchor syntax,
preserve containing controls and disclosures, and show the existing
localized help error without replaying failed actions.
- Carry destinations through existing choice rows, behavior settings and
core Status metadata; document the reusable pattern and update the
settings guide in all ten languages.

## Linked inventory

- General: automatic subsession expansion, keep-awake, Memory, Tidy up
and memory-review warning.
- Advanced: whitespace-only changes and session environment variables.
- OpenCode: startup launch.
- Providers: image generation and image storage.
- Notifications: On screen, History and System column tips.
- Speech: provider, separate providers, shared/input/output base URLs,
playback mode, output format, playback test and prompt voice input.
- Status: Tokens, Yolo mode, Usage, Background Shells, MCP and Plugins.

Mission creation/scheduling/depth/preferences belong to the separate
form change, which can use the shared prop directly. Dynamic mission
budget, attention and diagnostics tips retain their information-only
purpose. Existing `SettingsInfoLink` and integration `InfoPopoverButton`
explanations retain their actionable/runtime-specific popovers; sidebar
Info navigation and Info-card heading icons keep their distinct purpose.

## Validation

- `npm ci` in the isolated checkout.
- UI typecheck.
- URL/section checks: every literal contextual destination resolves in
all ten locales, including `zh-Hans`.
- Behavior and right-panel registry tests: 14 passed.
- Full help suite: 31 passed, validating 28 pages × 10 locales.
- Real Solid browser gesture and relevant settings regressions: 56
passed (new shared-tip cases, startup launch, General/appearance,
Memory, notifications and help-command routes). All eight new
gesture/native-route cases pass.
- The fixture-wiring audit reports two existing WebKit fixtures without
the required exemption/navigation-budget wiring; those files and the
audit inputs are unchanged from `origin/dev`.

## Scope

No Mission form/tree edits, new dependencies, URL registry, plugin
extension point or duplicated info component. Visible explanations and
opener errors reuse existing translations.

## Independent review and CI

Round 1 found a translation-readiness race in the browser test. The test
now waits for the real localized info-link label before activating it.
Round 2: **No findings**.

Current `origin/dev` is merged. CI has baseline failures in the
unchanged binary-build ordering expectation and Cargo lockfile; the unit
failure reproduces locally and the affected inputs match `origin/dev`.
The existing fixture-wiring audit likewise reports only unchanged WebKit
files. These are tracked in the PR discussion separately from
contextual-help validation. Additional platform jobs remain
queued/running; admin merge is explicitly authorized for this change.

## Real component capture

![Startup and keep-awake settings with the shared contextual info
tooltip](https://raw.githubusercontent.com/NeuralNomadsAI/CodeNomad/95c2ada0f/pr-assets/contextual-help.png)
2026-11-09 00:22:03 +01:00
..
de feat(help): open localized guide sections from contextual info icons (#1404) 2026-11-09 00:22:03 +01:00
en feat(help): open localized guide sections from contextual info icons (#1404) 2026-11-09 00:22:03 +01:00
es feat(help): open localized guide sections from contextual info icons (#1404) 2026-11-09 00:22:03 +01:00
fr feat(help): open localized guide sections from contextual info icons (#1404) 2026-11-09 00:22:03 +01:00
he feat(help): open localized guide sections from contextual info icons (#1404) 2026-11-09 00:22:03 +01:00
i18n feat: add a Support CodeNomad page and entry points for sponsorship (#1194) 2026-10-29 18:57:45 +01:00
ja feat(help): open localized guide sections from contextual info icons (#1404) 2026-11-09 00:22:03 +01:00
ne feat(help): open localized guide sections from contextual info icons (#1404) 2026-11-09 00:22:03 +01:00
ru feat(help): open localized guide sections from contextual info icons (#1404) 2026-11-09 00:22:03 +01:00
tr feat(help): open localized guide sections from contextual info icons (#1404) 2026-11-09 00:22:03 +01:00
zh-Hans feat(help): open localized guide sections from contextual info icons (#1404) 2026-11-09 00:22:03 +01:00
downloads.json feat(help): add a download page with exact release links and a new home page (#1190) 2026-10-29 16:06:06 +01:00
funding.json feat: add a Support CodeNomad page and entry points for sponsorship (#1194) 2026-10-29 18:57:45 +01:00
help-download.js feat(help): add a download page with exact release links and a new home page (#1190) 2026-10-29 16:06:06 +01:00
help-search.js docs(help): multilingual help site with in-app Help menu and palette entry (#859) 2026-10-14 22:44:56 +02:00
help.css fix(help): keep whole words in table columns (#1212) 2026-10-30 22:36:18 +01:00
site.json feat(missions): explain every playbook in help and a See details reader (#1226) 2026-10-31 04:50:52 +01:00