trails-cool/trails
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
trails/openspec/changes/changelog/proposal.md
Ullrich Schäfer c7c1c275df
Add 8 proposed changes and old trails analysis 
Proposed changes (all with proposal, design, specs, tasks):
- app-navigation (9 tasks) — nav bars for both apps
- planner-landing-page (7 tasks) — standalone landing page
- planner-multiplayer-awareness (13 tasks) — participants, cursors, names
- changelog (13 tasks) — public changelog with "what's new"
- transactional-emails (15 tasks) — magic link + welcome emails
- planner-features (18 tasks) — no-go areas, notes, recovery, rate limits
- komoot-import (23 tasks) — Komoot tour import
- route-features (37 tasks) — sharing, multi-day, spatial, photos

Also adds docs/old-trails-analysis.md with feature analysis from the
older trails project.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-25 03:57:20 +01:00

1.4 KiB
Raw Permalink Blame History

Why

We ship features but nobody knows. There's no record of what changed, no way to share progress, and no way for users to discover new features. A changelog serves three audiences: existing users (what's new), potential users (the project is alive and improving), and social followers (shareable updates).

What Changes

  • Add a /changelog page in the Journal showing dated entries with feature descriptions
  • Changelog entries stored as markdown files in the repo (not a database) — low friction, version controlled, works with the PR workflow
  • Each entry renders as a standalone shareable page (/changelog/2026-03-25) with Open Graph meta tags for social previews
  • A "What's New" badge/dot on the nav bar when there are entries the user hasn't seen
  • The changelog is public (no auth required) — it's part of the product's public face

Capabilities

New Capabilities

  • changelog: Public changelog with dated entries, shareable individual pages with OG tags, "what's new" indicator

Modified Capabilities

(None)

Impact

  • Files: New routes (/changelog, /changelog/:slug), markdown entry files in docs/changelog/ or apps/journal/changelog/, nav bar update
  • Dependencies: A markdown renderer (could reuse react-markdown or render at build time)
  • i18n: Changelog entries written in English (primary audience), German later if needed