Transcript gutter marks

Round 2, 17 Oct 2026, exploration only (round 1: transcript-quote-hooks.html). A new gutter between the text and the margin holds one mark per destination: Quotes (the lens's own text.quote mark) beside each quoted paragraph, Screens where a screen starts, and Discussion beside a moderator's question. The transcript sits on very pale paper; hover anywhere along a paragraph's row and its quotes lift to white while its marks darken; hover a mark and it turns blue. Click a mark or a margin title to see where it would take you (shown in the window's bar). Click the text to put the caret in it; you can't type.

artefact: what the product would drawcommentary: not the product

Sessions ▸ Session 2 ▸ transcript

Commentary · what to look at

Baselines. The first mark on a paragraph sits on the paragraph's first baseline, and on the same baseline as the margin's first title. Gutter and margin are one two-column block, so each further mark lines up with its own margin entry.
Order (01:56, 02:10). Section or theme, then its tags, then the screen last, so the thumbnail hangs into the free space below. The thumbnail never grows its row: it fades out under whatever follows (02:31's row, 01:56 into 02:10). Hover the screen's title, its thumbnail or its mark and it surfaces, unfaded, over the neighbouring margin text.
Same name (02:34). The screen is called "Shopping Bag" and so is the section: the name is said once, beside the quote mark, and the screen mark and thumbnail sit under it without repeating the words. Measured 17 Oct 2026 on the 8 local projects with screen text: of 123 quotes that sit on a screen, the section/theme name and the screen title were identical 8 times, all "Shopping Bag" (2 more where one contains the other, 9 sharing a word, 104 unrelated). So the merge rule will rarely fire. The common case is the same place under two names: German pages (Warenkorb beside "Shopping Bag", Lieferung oder Abholung beside "Checkout & Login"), and titles cut short or taken from a toast (Beds & mattres, Liefer, KORKEN were added to your shopping bag.).
Runs (00:55, 01:09). Same theme again: the mark only, no repeated title. 01:09's second quote (a section) gets its own mark and title.
Two quotes in one paragraph (01:09). Row hover lifts both. Hover one mark and only its quote gets the ring. The second mark sits at its margin entry, not at the line where its quote starts, which is fine until a paragraph is long.
Hidden (01:56). Grey ink, a grey mark and a grey title; it still lifts on hover, so you can see what was discounted. Clicking it is the concrete choice: Show in Quotes un-hides it.
Playback (toggle). The blue wash sits over the paper; the lift still reads, and the gutter is clear of the progress bar on the left.
Narrow. The gutter survives; the margin's titles and thumbnails drop under the text.
Discussion (00:22, 01:52). The mark, and the guide item the question was matched to, in grey: a link with a hover underline but no blue (owner, 17 Oct 2026: topic on).
No Signals mark, as agreed for now.

Commentary · editing (future): what it would tread on

Click is always the caret. Links live only on the marks and the margin titles; the text is never a link. Hover only lights and keylines, so it commits nothing. That division holds with full editing.
A document, not a form (owner, 17 Oct 2026). Clicking puts a caret in the text; the paper stays the paper, with no field fill and no edge. You fix a mishearing, add an [editorial note], split or join paragraphs, and it reads as one continuous text, as in any text editor. White and the keyline are only ever the chunk highlight, on hover, never because the caret is in a paragraph.
Right-click (Mac). The system's items first (Look Up, Translate, Cut/Copy/Paste), then where the paragraph leads (the quote under the pointer, or each quote here; its screen; its question), then Play from, then the paragraph's own actions (Split, Join, Change Speaker…), then Revert. On a hidden quote the item says "Unhide and Show in Quotes".
Not in the menu, on purpose: Substitutions and Spelling. Autocorrect and smart quotes would change a participant's words without anyone deciding to. Star/Hide/Tag would make the transcript a second place to curate; that's a separate decision.

Commentary · the data each mark needs

Mark	Where it comes from	Joined to a paragraph by	Link target	A way in today?	Issues
Quotes	`/transcripts/{sid}` annotations: `dom_id`, label, kind. Paragraphs carry `quote_ids`.	`quote_ids` on the paragraph, already there	Quotes lens, the group's `section-<id>` / `theme-<id>` anchor (ids since the rename work)	Partly: `scrollToAnchor`. No grouping override, no un-hide on arrival.	The annotation lacks the group id/anchor and is_hidden; both are one join each. A paragraph's quote count decides how many marks.
Screens	`/screens`: each screen's `tabs[]` for this session carry `visits` [[start, end], …] and a `crop`. Title from `screenTitle()`; thumbnail from `/screens/still?session_id&t&crop&w`.	A visit's start time → the paragraph containing it (`resolveSegmentForSeconds` exists)	Screens lens, that screen and this session's version	No. `reveal(key, sid)` is internal; it needs a route parameter.	Density: revisits and quick tab-switching could put a mark on most paragraphs; consecutive visits to one screen should collapse. Two sources: the session timeline's notches are colour changes, not screens; the identity is in `/screens`, so they can disagree. Availability: screen text must be on and indexed, so marks arrive late on a fresh project (poll while `pending`). Title is computed in the client (`screenTitle()` in ScreensLens.tsx); share it, don't copy it. Thumbnails are participants' screens: behind the bearer, never in an export; one small still per mark, fetched lazily. A visit starting mid-paragraph is drawn at the paragraph's top.
Discussion	`/discussion`: `turns[]` {`id` "s1@01:16", `session`, `sec`, `item`}; item names from `sections[].items`.	The turn's `sec` → the moderator paragraph containing it	Discussion lens, that item, scrolled to this turn	No. Focus {item, turn} lives in module memory (`lensState.ts`); needs a route parameter.	The record exists only after a discussion pass and can be stale. A merged moderator paragraph can hold several turns (several marks, or one?). Turns with `item: null` aren't questions and get no mark.

One load or three? The transcript already fetches /transcripts/{sid}. Screens and Discussion are separate reads; the simplest start is the client fetching all three and joining by time. A server-side /transcripts/{sid}/marks would do the joins once and make an offline export simpler, since it could leave Screens out by itself.
Exports. Quotes and Discussion marks can work offline; Screens marks and thumbnails cannot (the lens is not in the export).
Arrival. Each lens needs one new thing for these links to land: a route parameter (Screens: screen + session; Discussion: item + turn) and, for Quotes, the grouping override and un-hide already planned.