docs: Align product documentation with the shipped application (0.4.3) #159

Merged

ValleyGeek merged 3 commits from 0.4.2/docs-product-alignment into main

2026-08-13 02:35:31 +00:00

Grok commented

2026-08-13 02:31:25 +00:00

Member

Summary

Aligns the in-app user guide and supporting product docs with what the application actually does, and bumps VERSION to 0.4.3 because the bundled Help guide (resources/help/USER_GUIDE.md) is a compiled input.

User guide — full interaction reference for every workbench, toolbar, dialog, gesture, and default shortcut
README — overview only; drops stale claims (AND/OR tag filter, viewer fill/1:1, Keep Best as the current Keep UI)
TECHNICAL_OUTLINE / DESIGN / CLAUDE — spec and architecture match shipped behavior (search, AoT, Export/Delete All/Unused tags, Dupe Grid, Keep criteria, multi-tag sort, full-resolution viewer)
Status lines no longer pin a release version that would need bumping every ship

compiled-inputs-changed.sh origin/main exits 0 (bundled guide). Decision records are left as historical records.

Test plan

./scripts/check-version-bump.sh — VERSION 0.4.2 → 0.4.3
python3 scripts/get-version.py --canonical after pip install -e . — 0.4.3
Open Help in the app and spot-check Contents links plus Grid / Tags / Viewer / Duplicates / Trash / Settings

## Summary Aligns the in-app user guide and supporting product docs with what the application actually does, and bumps `VERSION` to **0.4.3** because the bundled Help guide (`resources/help/USER_GUIDE.md`) is a compiled input. - **User guide** — full interaction reference for every workbench, toolbar, dialog, gesture, and default shortcut - **README** — overview only; drops stale claims (AND/OR tag filter, viewer fill/1:1, Keep Best as the current Keep UI) - **TECHNICAL_OUTLINE / DESIGN / CLAUDE** — spec and architecture match shipped behavior (search, AoT, Export/Delete All/Unused tags, Dupe Grid, Keep criteria, multi-tag sort, full-resolution viewer) - Status lines no longer pin a release version that would need bumping every ship `compiled-inputs-changed.sh origin/main` exits 0 (bundled guide). Decision records are left as historical records. ## Test plan - [x] `./scripts/check-version-bump.sh` — VERSION `0.4.2` → `0.4.3` - [x] `python3 scripts/get-version.py --canonical` after `pip install -e .` — `0.4.3` - [ ] Open Help in the app and spot-check Contents links plus Grid / Tags / Viewer / Duplicates / Trash / Settings

Grok added 3 commits

2026-08-13 02:31:26 +00:00

docs: rewrite bundled user guide for the shipped product f40f8e703c

Replace the incomplete Help guide with a full interaction reference for
every workbench, toolbar, dialog, and default shortcut. Drop stale
claims that are not in the UI and document controls that were missing
from the previous guide.

docs: align product specs with the shipped application bc580166b0

Update README, TECHNICAL_OUTLINE, and DESIGN to match current behavior:
OR-only tag filter, Keep with criteria, full-resolution viewer, search,
Advance on Tag, multi-tag sort, and related workbench features. Remove
release-version status lines that would need bumping every ship.

docs: PR-prep for 0.4.3 documentation alignment

CI / lint (push) Successful in 15s

Details

CI / test (push) Successful in 3m9s

Details

CI / appimage (push) Successful in 21m21s

Details

CI / build-appimage (push) Successful in 0s

Details

CI / windows-exe (push) Successful in 27m21s

Details

CI / build-windows-exe (push) Successful in 0s

Details

41bee382b3

Replace the development VERSION with 0.4.3 and add a dated changelog
section. The bundled user guide is a compiled input, so this release
ships updated Help content with the rest of the product docs.