wealth/docs/decisions/0069-one-rendering-doc-per-...

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 Index no. Notes give each app's difference as bull: …; bear: ….
  • Admin routes keep their own folder, docs/pages/wall-street-plaza/, with the desktop: 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 market and wall-street-plaza, not under bull and bear.