Skip to content

docs: USER-GUIDE.md — Exploring + Comparing + Your data (content complete)#111

Merged
kbennett2000 merged 1 commit into
mainfrom
slice/docs-4-user-guide
Jun 9, 2026
Merged

docs: USER-GUIDE.md — Exploring + Comparing + Your data (content complete)#111
kbennett2000 merged 1 commit into
mainfrom
slice/docs-4-user-guide

Conversation

@kbennett2000

Copy link
Copy Markdown
Owner

What landed

Fills the last three stubbed sections of docs/USER-GUIDE.md (continuing #109/#110), in the same voice and shape. After this, no (Coming soon.) stub remains — the guide's content is complete.

Exploring places and journeys — picks up the forward-link Slice 3 left from Study tools:

  • Places (places-gazetteer.png) — the gazetteer of 1,340+ locations; search + Status/Type filters → place detail (place-detail.png: Rameses, modern name, the verses that name it, and the "Journeys through here" block that bridges into Journeys).
  • Journeys (journeys-list.png, journey-detail.png) — the curated list → a route on the map with numbered stops + an ordered Stops list, each tied to a passage. The honesty caveat is the section's spine: one scholarly reconstruction, not a GPS track; uncertain crossing/stations shown honestly; unlocated stops listed but marked "Location unknown" and left off the map, not pinned.

Comparing translations (compare.png) — up to three translations in parallel columns, lined up verse for verse, with per-column read-only notes.

Your data — a short closer recapping privacy, Export/Import, and theme via back-links (no new screenshots), plus the guide's wrap.

Accuracy (verified against the app)

  • Journeys honesty mirrors the in-app amber callout (JourneyDetailView.tsx:66–71); unlocated-stop behavior from JourneyDetailView.tsx:84–123.
  • Compare stated from source — MAX_COLUMNS = 3, read-only per-column annotation overlays (CompareView.tsx); per-column notes described as behavior, not claimed visible in the shot.
  • ## Your data heading kept (not renamed) so the TOC anchor #your-data keeps resolving.

Scope / verification

  • Untouched: README.md (Slice 5). No app/test/screenshot change.
  • grep "Coming soon" → 0; all 5 new image links resolve from docs/; every internal anchor (#study-tools, #getting-started-in-the-app, #finding-things, #reading) matches a heading; TOC unchanged.
  • Docs-only, gates unaffected — make check 241 passed / 4 deselected; make check-frontend 221 passed, build clean.

🤖 Generated with Claude Code

…lete)

Fill the last three stubbed sections. Exploring walks the Places gazetteer
→ place detail (with "Journeys through here") → Journeys list → journey
detail, foregrounding the in-app honesty callout: a route is one scholarly
reconstruction, unlocated stops are listed but not pinned. Comparing covers
up to three parallel verse-aligned columns with read-only per-column notes.
Your data is a short closer recapping privacy, Export/Import, and theme with
back-links, plus the guide's wrap.

Journeys honesty + Compare behavior verified against JourneyDetailView.tsx
and CompareView.tsx. Heading kept as "## Your data" to preserve the TOC
anchor. No "(Coming soon.)" stub remains — the guide's content is complete.
README untouched (Slice 5). Docs-only — gates unaffected.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@kbennett2000 kbennett2000 merged commit 829245e into main Jun 9, 2026
2 checks passed
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