1.4 KiB
1.4 KiB
0069 One rendering doc per market route
Status: Proposed · Area: architecture · Date: 2026-10-21 · Decided by: agent
Context
Every page needs a rendering doc in docs/pages/<app>/. bull (mobile) and bear (desktop) serve the same route tree from platforms/market (0001), and an edge in front of them picks the app by device. Googlebot Smartphone reads bull's HTML and desktop crawlers read bear's, so the "both templates" checks in a rendering doc compare the two apps.
Decision
- Document each bull and bear route once, in
docs/pages/market/<page>.md. bull is the doc's mobile template and bear its desktop template; the Sections table follows bull's document order. - A row only one app renders ends with
(bull)or(bear)and is Indexno. Notes give each app's difference asbull: …; bear: …. - Admin routes keep their own folder,
docs/pages/wall-street-plaza/, with thedesktop:breakpoint as the desktop template (0063).
Alternatives
- One doc per app (
docs/pages/bull/,docs/pages/bear/): twice the docs for the same sections, which drift apart, and no single place to check that both apps put primary content in the first flush.
Consequences
- A change to a page in one app updates the shared doc, and the reviewer checks the other app still matches it.
- The index file groups the docs under
marketandwall-street-plaza, not under bull and bear.