There was an error while loading. Please reload this page.
Updated OBA API Defect Workshop (markdown)
docs: note that boarding areas (3-level hierarchy) are out of scope The GTFS spec permits Station → Platform → Boarding Area. This spec currently assumes a maximum of two levels.
fix: remove incorrect recursive resolution claim from references.stops The parent record in references.stops has all fields populated from the database. The previous wording incorrectly stated that parent would always be "" and framed this as a no-recursive-resolution guarantee, which is misleading.
Add dual-implementation client impact analysis to defect workshop Notes that the legacy API will remain in service alongside Maglev, requiring clients to handle both behaviours simultaneously. Adds a standing note to Decision Criteria and specific per-defect paragraphs for DC-1, DC-2, DC-4a, DC-5, DC-9, and DC-11 where this materially changes the impact picture. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Remove unneeded section
Add OBA API defect workshop document 19 defect classes covering all observable legacy API defects, grouped by root cause with client impact analysis and inline decision fields for use in the workshop. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Remove implementation opinions from API specs Specs describe legacy OBA behaviour only. Any opinion on what Maglev should do belongs exclusively in the Implementation Decisions section. Prescriptive sentences ("The Go implementation should...", "A clean Go reimplementation should...") have been removed or rephrased as tentative statements about what the original developer probably intended ("The intended behaviour was probably..."), so the defect context is preserved without preempting implementation decisions. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Record Maglev decision to return 404/400 for unknown/malformed stop ID in stop Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Record Maglev decision to return 404 for unknown stop in schedule-for-stop Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Record Maglev decision to return 404 for unknown stop/trip in arrival-and-departure-for-stop Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Record Maglev decision to return 404 for unknown agency in route-ids-for-agency Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Record Maglev decision to return 404 for unknown agency in routes-for-agency Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Record Maglev decision to return 404 for unknown agency in stop-ids-for-agency Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Document Maglev deviation: unknown agency ID returns 404 Adds cross-reference to the suspected defect entry and a new Implementation Decisions section explaining that Maglev intentionally returns HTTP 404 for unknown agency IDs rather than HTTP 200 with null. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Updated _Sidebar (org)
Clean up sidebar: add ADRs and OBA API Specs sections
Updated Home (markdown)
Fix index of specs
Update OBA API specs (2026-05-11T23:15:18Z)
Update OBA API specs (2026-05-11T23:13:08Z)
Updated ADR‐0001: Adopt Architecture Decision Records (markdown)
Updated ADR‐0002: Configuration by Environment Variables (markdown)
Updated Architecture Decision Records (ADRs) (markdown)