Problem
ARCHITECTURE.md and CHANGELOG.md both predate three major features that have since shipped and been closed out across 15+ issues each: the competitions vertical (#193-#210, #218-#226: schema, browse/detail pages, saves, calendar feed, public API, docs), the onboarding questionnaire (#203-#204), and the site-wide search bar (#222).
CHANGELOG.md has zero mentions of any of it:
$ grep -n "competition\|onboarding\|site search\|nav search" CHANGELOG.md
# (no hits — 250 lines, nothing)
The most recent full entry ([2.4.0]) and the current [Unreleased] section only cover docs/UI polish; none of the competitions/onboarding/search work is recorded anywhere, even though package.json is still at 2.4.0 and all of that work is already merged to main.
ARCHITECTURE.md's route table (under ### src/app/) and its src/components//src/lib/ breakdowns don't mention any of it either — comparing the documented routes against what actually exists in src/app/:
$ find src/app -maxdepth 1 -type d
about account api calendar city competitions contribute docs legal login map offline onboarding
/competitions, /competitions/[slug], /competitions/saved, /city/[slug], /account, /onboarding, /api/places, and /api/competitions are all real, working routes with no row in ARCHITECTURE.md's route table. The src/components/ tree in the same file lists home/, map/, calendar/, pins/, layout/, legal/, docs/, ui/ — but not the competitions/ or onboarding/ component directories, both of which exist and are non-trivial (competitions/ alone has 9 components). The src/lib/ table is missing competitions.ts, competitions-api.ts, competitions-share.ts, competition-events.ts, competition-saves.ts, user-profile.ts, search.ts, docs-nav.ts, docs-meta.ts, ics.ts, jsonld.ts, calendar-feed.ts, and more — most of src/lib/ isn't in the table at all anymore.
Fix
- Add
[Unreleased] (or versioned) CHANGELOG.md entries summarizing the competitions vertical, onboarding flow, and site search, since none of it is recorded anywhere.
- Update
ARCHITECTURE.md's route table, src/components/ tree, and src/lib/ table to include the routes/components/modules listed above.
Acceptance criteria
Problem
ARCHITECTURE.mdandCHANGELOG.mdboth predate three major features that have since shipped and been closed out across 15+ issues each: the competitions vertical (#193-#210, #218-#226: schema, browse/detail pages, saves, calendar feed, public API, docs), the onboarding questionnaire (#203-#204), and the site-wide search bar (#222).CHANGELOG.mdhas zero mentions of any of it:The most recent full entry (
[2.4.0]) and the current[Unreleased]section only cover docs/UI polish; none of the competitions/onboarding/search work is recorded anywhere, even thoughpackage.jsonis still at2.4.0and all of that work is already merged tomain.ARCHITECTURE.md's route table (under### src/app/) and itssrc/components//src/lib/breakdowns don't mention any of it either — comparing the documented routes against what actually exists insrc/app/:/competitions,/competitions/[slug],/competitions/saved,/city/[slug],/account,/onboarding,/api/places, and/api/competitionsare all real, working routes with no row in ARCHITECTURE.md's route table. Thesrc/components/tree in the same file listshome/,map/,calendar/,pins/,layout/,legal/,docs/,ui/— but not thecompetitions/oronboarding/component directories, both of which exist and are non-trivial (competitions/alone has 9 components). Thesrc/lib/table is missingcompetitions.ts,competitions-api.ts,competitions-share.ts,competition-events.ts,competition-saves.ts,user-profile.ts,search.ts,docs-nav.ts,docs-meta.ts,ics.ts,jsonld.ts,calendar-feed.ts, and more — most ofsrc/lib/isn't in the table at all anymore.Fix
[Unreleased](or versioned)CHANGELOG.mdentries summarizing the competitions vertical, onboarding flow, and site search, since none of it is recorded anywhere.ARCHITECTURE.md's route table,src/components/tree, andsrc/lib/table to include the routes/components/modules listed above.Acceptance criteria
CHANGELOG.mdhas at least a summary entry for competitions, onboarding, and site searchARCHITECTURE.md's route table includes every route currently undersrc/app/ARCHITECTURE.md's component/lib breakdown mentionscompetitions/andonboarding/component directories and the missingsrc/lib/modules