Codebook catalogue — install on the page

An idea, not a decision. Framed panes are the product: the shipped markup captured from a running serve (smoke fixture, project "Smoke Test"), edited only where the proposal changes it, at shipped CSS. The hatched block at the end is commentary. UXR and Morville are drawn as installed in the proposed catalogues; the fixture installs only Sentiment.

1 · The catalogue — no buttons; the whole card opens the codebook

ShippedInstall / Uninstall on every card
Emotional & Cognitive Signals
On by default
Seven sentiment categories designed for UX research.
7 tags · applied to 4 quotes in Smoke Test
Bristlenose UXR Codebook
Available by default
A practitioner-oriented codebook for any user research study.
34 tags · none applied to Smoke Test
Command-Line UX
Available by default
Tags for research on command-line tools, developer tools, and sysadmin workflows — anywhere the primary interface is a terminal.
35 tags
The Elements of User Experience
Jesse James Garrett
Five planes of user experience, from abstract to concrete — strategy, scope, structure, skeleton, surface — each dependent on the plane below it, and each with two sides: the product as functionality and the product as information.
18 tags
The User Experience Honeycomb
Peter Morville
Seven facets of user experience — useful, usable, desirable, findable, accessible, credible, valuable — drawn as a honeycomb so that each can be "a singular looking glass" on a product.
15 tags · applied to 3 quotes in Smoke Test
10 Usability Heuristics for User Interface Design
Jakob Nielsen
Ten broad rules of thumb for interaction design, refined from a factor analysis of 249 usability problems.
34 tags
The Design of Everyday Things
Don Norman
Norman's seven fundamental principles of design — discoverability, feedback, conceptual model, affordances, signifiers, mappings and constraints — plus his classification of human error into slips and mistakes.
28 tags
Laws of UX
Jon Yablonski
A collection of psychological principles that underpin user experience, drawn from cognitive psychology, perception science, and behavioural economics.
24 tags
Platonic Ontology & Epistemology
Composite — Vlastos, Fine, Kraut, Sedley
A scholarly codebook for analysing Plato's dialogues through the lens of his ontology (Theory of Forms, cosmology, soul) and epistemology (knowledge vs opinion, dialectic, recollection).
26 tags
Proposed — marker A✓ Installed where the button was · owner-written word
Emotional & Cognitive Signals
On by default
Seven sentiment categories designed for UX research.
7 tags · applied to 4 quotes in Smoke TestInstalled
Bristlenose UXR Codebook
Available by default
A practitioner-oriented codebook for any user research study.
34 tags · none applied to Smoke TestInstalled
Command-Line UX
Available by default
Tags for research on command-line tools, developer tools, and sysadmin workflows — anywhere the primary interface is a terminal.
35 tags
The Elements of User Experience
Jesse James Garrett
Five planes of user experience, from abstract to concrete — strategy, scope, structure, skeleton, surface — each dependent on the plane below it, and each with two sides: the product as functionality and the product as information.
18 tags
The User Experience Honeycomb
Peter Morville
Seven facets of user experience — useful, usable, desirable, findable, accessible, credible, valuable — drawn as a honeycomb so that each can be "a singular looking glass" on a product.
15 tags · applied to 3 quotes in Smoke TestInstalled
10 Usability Heuristics for User Interface Design
Jakob Nielsen
Ten broad rules of thumb for interaction design, refined from a factor analysis of 249 usability problems.
34 tags
The Design of Everyday Things
Don Norman
Norman's seven fundamental principles of design — discoverability, feedback, conceptual model, affordances, signifiers, mappings and constraints — plus his classification of human error into slips and mistakes.
28 tags
Laws of UX
Jon Yablonski
A collection of psychological principles that underpin user experience, drawn from cognitive psychology, perception science, and behavioural economics.
24 tags
Platonic Ontology & Epistemology
Composite — Vlastos, Fine, Kraut, Sedley
A scholarly codebook for analysing Plato's dialogues through the lens of his ontology (Theory of Forms, cosmology, soul) and epistemology (knowledge vs opinion, dialectic, recollection).
26 tags

Marker alternatives, same catalogue

Marker Btick before the title, word in a tooltip
Emotional & Cognitive Signals
On by default
Seven sentiment categories designed for UX research.
7 tags · applied to 4 quotes in Smoke Test
Bristlenose UXR Codebook
Available by default
A practitioner-oriented codebook for any user research study.
34 tags · none applied to Smoke Test
Command-Line UX
Available by default
Tags for research on command-line tools, developer tools, and sysadmin workflows — anywhere the primary interface is a terminal.
35 tags
The Elements of User Experience
Jesse James Garrett
Five planes of user experience, from abstract to concrete — strategy, scope, structure, skeleton, surface — each dependent on the plane below it, and each with two sides: the product as functionality and the product as information.
18 tags
The User Experience Honeycomb
Peter Morville
Seven facets of user experience — useful, usable, desirable, findable, accessible, credible, valuable — drawn as a honeycomb so that each can be "a singular looking glass" on a product.
15 tags · applied to 3 quotes in Smoke Test
10 Usability Heuristics for User Interface Design
Jakob Nielsen
Ten broad rules of thumb for interaction design, refined from a factor analysis of 249 usability problems.
34 tags
The Design of Everyday Things
Don Norman
Norman's seven fundamental principles of design — discoverability, feedback, conceptual model, affordances, signifiers, mappings and constraints — plus his classification of human error into slips and mistakes.
28 tags
Laws of UX
Jon Yablonski
A collection of psychological principles that underpin user experience, drawn from cognitive psychology, perception science, and behavioural economics.
24 tags
Platonic Ontology & Epistemology
Composite — Vlastos, Fine, Kraut, Sedley
A scholarly codebook for analysing Plato's dialogues through the lens of his ontology (Theory of Forms, cosmology, soul) and epistemology (knowledge vs opinion, dialectic, recollection).
26 tags
Marker Cthe word leads the status line
Emotional & Cognitive Signals
On by default
Seven sentiment categories designed for UX research.
Installed · 7 tags · applied to 4 quotes in Smoke Test
Bristlenose UXR Codebook
Available by default
A practitioner-oriented codebook for any user research study.
Installed · 34 tags · none applied to Smoke Test
Command-Line UX
Available by default
Tags for research on command-line tools, developer tools, and sysadmin workflows — anywhere the primary interface is a terminal.
35 tags
The Elements of User Experience
Jesse James Garrett
Five planes of user experience, from abstract to concrete — strategy, scope, structure, skeleton, surface — each dependent on the plane below it, and each with two sides: the product as functionality and the product as information.
18 tags
The User Experience Honeycomb
Peter Morville
Seven facets of user experience — useful, usable, desirable, findable, accessible, credible, valuable — drawn as a honeycomb so that each can be "a singular looking glass" on a product.
Installed · 15 tags · applied to 3 quotes in Smoke Test
10 Usability Heuristics for User Interface Design
Jakob Nielsen
Ten broad rules of thumb for interaction design, refined from a factor analysis of 249 usability problems.
34 tags
The Design of Everyday Things
Don Norman
Norman's seven fundamental principles of design — discoverability, feedback, conceptual model, affordances, signifiers, mappings and constraints — plus his classification of human error into slips and mistakes.
28 tags
Laws of UX
Jon Yablonski
A collection of psychological principles that underpin user experience, drawn from cognitive psychology, perception science, and behavioural economics.
24 tags
Platonic Ontology & Epistemology
Composite — Vlastos, Fine, Kraut, Sedley
A scholarly codebook for analysing Plato's dialogues through the lens of his ontology (Theory of Forms, cosmology, soul) and epistemology (knowledge vs opinion, dialectic, recollection).
26 tags

2 · Click a card: the codebook page, where Install lives

Proposedshipped page + one owner-written line under the status
The Elements of User Experience
Jesse James Garrett
18 tags · not installed
Installing proposes one of these 18 tags for each of the 4 quotes in Smoke Test. Nothing is applied until you review the proposals.

Five planes of user experience, from abstract to concrete — strategy, scope, structure, skeleton, surface — each dependent on the plane below it, and each with two sides: the product as functionality and the product as information.

A framework for locating where in the design stack a finding lives: the objectives and needs behind the product, the features and content it includes, how its parts are arranged, how each screen is laid out, and what the senses meet.

Jesse James Garrett
Co-founded the user experience consultancy Adaptive Path in 2001 (it became part of Capital One in 2014) and now coaches and advises design leaders. Coined the term "Ajax" (2005). The five-plane "Elements" diagram of March 2000 became "The Elements of User Experience" (New Riders, 2002; 2nd ed. "User-Centered Design for the Web and Beyond", 2010).
Strategy

Is the product solving the right problem, for its users and for its makers?

user need
0
product objective
0
success metric
0
brand identity
0
Scope

Does the product include the right features and content?

functional requirement
0
content requirement
0
requirement priority
0
scope creep
0
Structure

How do the pieces fit together — the flows and the organisation of content?

interaction design
0
information architecture
0
error handling
0
Skeleton

How is each screen laid out — the interface, the navigation, the information?

interface design
0
navigation design
0
information design
0
convention
0
Surface

What do the senses meet — colour, type, contrast, consistency?

visual design
0
contrast and uniformity
0
consistency
0

3 · After Install, once the run has finished

Shipped as isUninstall in the title row · the Review door
The Elements of User Experience
Jesse James Garrett
18 tags · none applied to Smoke Test · 4 tentative

Five planes of user experience, from abstract to concrete — strategy, scope, structure, skeleton, surface — each dependent on the plane below it, and each with two sides: the product as functionality and the product as information.

A framework for locating where in the design stack a finding lives: the objectives and needs behind the product, the features and content it includes, how its parts are arranged, how each screen is laid out, and what the senses meet.

Jesse James Garrett
Co-founded the user experience consultancy Adaptive Path in 2001 (it became part of Capital One in 2014) and now coaches and advises design leaders. Coined the term "Ajax" (2005). The five-plane "Elements" diagram of March 2000 became "The Elements of User Experience" (New Riders, 2002; 2nd ed. "User-Centered Design for the Web and Beyond", 2010).
Strategy

Is the product solving the right problem, for its users and for its makers?

user need
0
product objective
0
success metric
0
brand identity
0
Scope

Does the product include the right features and content?

functional requirement
0
content requirement
0
requirement priority
0
scope creep
0
Structure

How do the pieces fit together — the flows and the organisation of content?

interaction design
0
information architecture
0
error handling
0
Skeleton

How is each screen laid out — the interface, the navigation, the information?

interface design
0
navigation design
0
information design
0
convention
0
Surface

What do the senses meet — colour, type, contrast, consistency?

visual design
0
contrast and uniformity
0
consistency
0
Commentary

The problem. In testing, people installed from the card without knowing what they were getting, and Install starts an AutoCode run (D4: installing is applying). The card shows a title, an author and one sentence; the page shows every group and tag, the author and their sources. The decision belongs where the evidence is.

The flow. The catalogue becomes a catalogue: each card is already a button that opens its codebook (D12), so removing Install / Uninstall costs no route. Install and Uninstall already live in the page's title row; nothing moves there, it just becomes the only place. Sentiment's card already has no button today, so a button-less card is a shipped shape, not a new one.

The marker. A: a tick and "Installed" where the button was, so the eye finds it in the same place. B: a tick before the title, quieter, the word only in a tooltip (hover-only, so weaker for keyboard and screen-reader users unless it is also in the label). C: the word leads the status line, no glyph. The status phrase already differs (installed cards say "applied to…" or "none applied to…"), so the marker restates a fact the card half-carries; A makes it scannable. Not-installed cards show nothing: absence is the information.

The page line. Under the status, one sentence saying what Install does, true to the code: the first run leaves every proposal pending until it is reviewed. It is also where D4's unmet obligation could land ("the number moves to the install control"); the alternative is to put the count on the button ("Install and code 4 quotes").

New stringWhereNote
Installedcatalogue marker (A, B tooltip, C)new key; the page's own "not installed" in CodebookV2Page.tsx is a hardcoded English literal today and would want a key at the same time
Installing proposes one of these {{tags}} tags for each of the {{quotes}} quotes in {{project}}. Nothing is applied until you review the proposals.page, under the status, not installed onlynew key, pluralised on both counts; owner to word

What would change in code. The card's button and its handlers go (CodebookV2Browse.tsx), with the .picker-card-toggle rules; one marker element and its rule arrive. The Mac Codes menu keeps its Install / Uninstall row, which acts on the focused codebook, so it is unaffected.