trails/openspec/changes/credits-page/specs/credits-page/spec.md
Ullrich Schäfer 5dd4968626 docs+openspec: prior-art research (Organic Maps, Endurain, wanderer) and 15 proposals
Add docs/inspirations.md as the durable record of the 2026-07-05/06
prior-art research — per-project learnings with source paths, canonical
credit lines, and the changes each spawned — and extend the
acknowledgment lists in philosophy.md/architecture.md (Organic Maps,
Endurain, wanderer).

New OpenSpec changes (proposal/design/specs/tasks each):
- Organic Maps: elevation-profile-hardening, gpx-parser-robustness,
  hiking-time-estimate, poi-index, hiking-foot-profile
- Endurain: account-export, activity-duplicate-review,
  fit-parsing-hardening, activity-locations, self-hosting-guide,
  activity-privacy-controls
- wanderer: federation-hardening, link-share-tokens
- credits-page (user-visible acknowledgments)

Updated in-flight changes with wanderer prior-art sections:
route-federation, route-discovery.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-06 07:23:00 +02:00

1,001 B

ADDED Requirements

Requirement: Credits page

The Journal SHALL serve a credits page at /about/credits with three sections — inspirations (linked projects with a one-line acknowledgment each, matching the list in docs/philosophy.md), data attributions (including "© OpenStreetMap contributors" per ODbL guidelines and, once shipped, GeoNames CC-BY), and key open-source components. All strings SHALL be localized.

Scenario: Page renders with inspirations

  • WHEN a user (authenticated or not) opens /about/credits
  • THEN the page lists BRouter, bikerouter.de, brouter-web, Organic Maps, Endurain, and wanderer with links and acknowledgment lines

Scenario: Localized content

  • WHEN the UI locale is German
  • THEN headings and acknowledgment lines render in German

Scenario: OSM attribution wording

  • WHEN the data section renders
  • THEN it contains the canonical "© OpenStreetMap contributors" attribution with a link to the OSM copyright page