justinzeus/spreadlab
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: brief paths from the course workspace root

Browse source 
The design session runs in the VS Code extension from the course
workspace, one level above this repo; spell every referenced path from
there so nothing depends on the session's working directory.
This commit is contained in:
Justin Visser 2026-06-10 14:21:43 +02:00
parent 6aeb7b5198
commit 5196ed270b
1 changed files with 13 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

22
docs/ui-design-brief.md
View file

@ -31,15 +31,19 @@ must land in seconds), curious public on the hosted demo, the author.
## What already exists (look at it) ## What already exists (look at it)
- Run `./dev.sh` from the repo root and open http://localhost:5173 to see Paths below are given from the course workspace root
the current parity page (a static table of the three scenarios). (/home/jv/src/uni/ai-in-open-society); the repo itself is
grant-proposal/tool/.
- Run ./dev.sh from grant-proposal/tool/ and open http://localhost:5173 to
see the current parity page (a static table of the three scenarios).
- The Python prototype's rendered output defines the inherited visual - The Python prototype's rendered output defines the inherited visual
language: ../pitch/figure/out/spread.png and spread.gif (relative to the language: grant-proposal/pitch/figure/out/spread.png and spread.gif.
repo root's parent: grant-proposal/pitch/figure/out/). Teal donut ring = Read the PNG; it is the look to inherit. Teal donut ring = educated,
educated, rose = forwarded the fake, haloed node = origin, slate = rose = forwarded the fake, haloed node = origin, slate = unreached;
unreached; colourblind-safe via shape, not colour alone. Modern-dashboard colourblind-safe via shape, not colour alone. Modern-dashboard look,
look, Tailwind-ish palette (see constants in Tailwind-ish palette (see constants in
../pitch/figure/spread_figure.py). grant-proposal/pitch/figure/spread_figure.py).
- API: GET /api/config/default, POST /api/comparison (full Config in, all - API: GET /api/config/default, POST /api/comparison (full Config in, all
three strategies' Results out). Result.reachedAtRound gives per-node three strategies' Results out). Result.reachedAtRound gives per-node
activation rounds, exactly what an animation needs. Types in activation rounds, exactly what an animation needs. Types in
@ -48,7 +52,7 @@ must land in seconds), curious public on the hosted demo, the author.
network view needs. The spec should state what the frontend needs from a network view needs. The spec should state what the frontend needs from a
new/extended endpoint; the implementation session will add it. new/extended endpoint; the implementation session will add it.
## Locked decisions the spec must respect (from ../tool-handoff.md) ## Locked decisions the spec must respect (from grant-proposal/tool-handoff.md)
- Layout is computed in the frontend with a force simulation (d3-force or - Layout is computed in the frontend with a force simulation (d3-force or
equivalent) seeded from the config: a shared URL must render the same equivalent) seeded from the config: a shared URL must render the same