From 4309898ec80f93957ae2998a5eccabff6a19c869 Mon Sep 17 00:00:00 2001 From: StanisLove Date: Tue, 14 Jul 2026 13:57:07 +0300 Subject: [PATCH] Add design and product documentation --- DESIGN.md | 17 +++++++++++++++++ PRODUCT.md | 22 ++++++++++++++++++++++ 2 files changed, 39 insertions(+) create mode 100644 DESIGN.md create mode 100644 PRODUCT.md diff --git a/DESIGN.md b/DESIGN.md new file mode 100644 index 0000000..33ec362 --- /dev/null +++ b/DESIGN.md @@ -0,0 +1,17 @@ +# Design — Common Ground + +## Direction + +Editorial newsroom meets public ledger: human stories, documentary imagery, visible evidence, and restrained civic color. + +## System + +- Use semantic tokens, editorial type hierarchy, and asymmetric but readable grids. +- Keep documents, budgets, and dates visually distinct from narrative content. +- Avoid card grids as the default; use rhythm, rules, captions, and section composition. +- Motion supports story progression only and must not obscure evidence. +- Mobile retains captions, provenance, and action context. + +## Intentional patterns + +Hairlines, index numbers, and side rules are intentional editorial navigation devices when consistently applied. diff --git a/PRODUCT.md b/PRODUCT.md new file mode 100644 index 0000000..c8dd446 --- /dev/null +++ b/PRODUCT.md @@ -0,0 +1,22 @@ +# Product — Common Ground + +Status: approved baseline. + +## Audience and job + +Supporters, volunteers, partners, and journalists need to verify where resources go, understand active campaigns, and take a concrete next action. + +## Primary journeys + +1. Discover a campaign through evidence-backed reporting. +2. Inspect budgets, progress, documents, and human stories. +3. Donate, volunteer, or share with informed consent. + +## Non-goals + +- No vague impact totals without methodology or source documents. +- No exploitative imagery or manipulative urgency. + +## Success criteria + +Every campaign connects narrative to verifiable evidence, and action paths explain commitment, privacy, and follow-up.