Home / About / Engineering / 064: Findability: five desks, a controlled vocabulary, series, formats and reading time, derived once

Engineering · done

064: Findability: five desks, a controlled vocabulary, series, formats and reading time, derived once

Findability: five desks, a controlled vocabulary, series, formats and reading time, derived once

Id064
Statusdone
Kindfeature
Priorityhigh
Created2026-10-14T18:10:00Z
Sourcecard 051's order of work ("the data first: desks, tags, series, formats"), from the Newsroom Design Lab's newsroom-proto-find vault; the owner: "pull the latest articles and just start taking from there
Releasev0.12.60
Effortmedium
Fileadmin/engineering/issues/done/064-findability-desks-tags-series-formats.md

What is asked

The lab's finding was that 123 articles under six topics and 504 raw tags (most used once) cannot be found by the reader they are for. Its derivation (a desk is an audience; each controlled tag belongs to one desk; an article scores by its tags and topics; the editor overrides and says why) is carried over with its rules intact, run on today's wire, and written once as data every page reads and the API will serve.

Scenario

Given the wire, every article's markdown twin and the editor's file
When find.py runs
Then every article has a primary desk, a secondary when it touches one, its controlled tags, its series and position, a format and reading minutes
And a raw tag the editor has not mapped is listed for the Librarian and does not stop the build
And each desk has a page: who it is for, three to start with and why, its series in order, every article newest first

Outcome

admin/content/find/find-editorial.json (ported from the lab, status accepted), admin/build/find.py → articles/find.json (desks security 35, building 25, vaults 20, news 24, strategy 19; 42 controlled tags from 504 raw, 165 unmapped and listed; 11 series; reading minutes at 230 words a minute from the first h2 to Threads). admin/build/desks.py → desks/index.html and desks/<id>.html. The front page's chips, desk sections and start-here lists read it.

Back to the board.

For an agent

Issue 064 on newsroom.sgit.ai: Findability: five desks, a controlled vocabulary, series, formats and reading time, derived once. Status done, kind feature, priority high, release v0.12.60. Source file admin/engineering/issues/done/064-findability-desks-tags-series-formats.md.