From 90a8bb25cfbd3cdfe589f93a965a33b1f59ab895 Mon Sep 17 00:00:00 2001 From: Tobias Gesellchen Date: Sat, 23 May 2026 00:19:36 +0200 Subject: [PATCH] fix(docs): update docs/README.md after archive moves The markdown-link-check CI step caught five stale links in docs/README.md's Concept Documentation section pointing at files the previous commit moved into docs/archive/. Replaced with a pointer to SUMMARY.md's Concepts section + a short curated list of the currently-relevant docs (Spotify Overview, Spotify OAuth, Amazon Music OAuth, Encrypted Export, Request Recording). The archived planning artefacts get a single line acknowledging their existence under docs/archive/. Co-Authored-By: Claude Sonnet 4.6 --- docs/README.md | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/docs/README.md b/docs/README.md index f778bbf..4a61eda 100644 --- a/docs/README.md +++ b/docs/README.md @@ -66,14 +66,15 @@ The documentation is organized into three main categories: ## 🏗 Concept Documentation -### Enhanced Service Architecture -- **[Concept Overview](concepts/README.md)** - High-level architecture vision -- [Upstream Service Simulation](concepts/upstream-service-simulation.md) - Complete concept design -- [Implementation Plan](concepts/implementation-plan.md) - Development roadmap -- [Technical Specification](concepts/technical-specification.md) - Detailed specifications +Current concept docs are listed under the **Concepts** section of [SUMMARY.md](SUMMARY.md#concepts). Highlights: -### Development Planning -- [Implementation Roadmap](concepts/implementation-roadmap.md) - Project phases and milestones +- [Spotify Overview](concepts/spotify-overview.md) — mental model, Spotify Connect vs OAuth-intercept, DNS rewrite gotcha +- [Spotify OAuth](concepts/spotify-oauth.md) — flows and management endpoints +- [Amazon Music OAuth](concepts/amazon-music-oauth.md) — companion to Spotify OAuth; same protocol shape, different scopes +- [Encrypted Export](concepts/ENCRYPTED-EXPORT.md) — `.age`-encrypted diagnostic bundles +- [Request Recording](REQUEST_RECORDING_CONCEPT.md) — how the proxy captures live device traffic for parity testing + +Older planning artefacts ("Enhanced State Management System", "Upstream Service Simulation") live under [docs/archive/](archive/) — kept for the record, no longer current. ## 💡 Quick Reference