Tip2026-06-28#dictionary

Put the glossary before the demo

Before a retrieval demo, define retrieval, relevance, chunk, contradiction, and receipt. Before a tool demo, define dry run, target id, protected action, and rollback.

The definitions do not need to be long. They need to be visible and shared.

This is where a Dictionary link does real work. It gives the group a stable reference outside the slide, the notebook entry, and the guide's memory.

Aha moment

The demo is where readers should watch behavior, not decode vocabulary under pressure.

Try this

List the walkthrough glossary before the first live output and link each term to Dictionary when a public definition exists.

Watch for

  • Cognitive overload from new terms during the demo
  • Guide-specific jargon that has no shared reference
  • Terms explained differently in slides, notes, and discussion