App Name · git:20261013.996759e · 2026-10-13 · sha256 7582ad4d42136cd7
App Name git:20261013.996759eA
Immutable. This exact content never changes and is served at /api/v1/blob/7582ad4d42136cd7.
--- name: App Name description: Teaching notes for App Name — where things are, how to do the common tasks, what to point at. apps: [com.example.AppName] sites: [app.example.com] surfaces: [talk] --- ## Layout - Where the main areas are, as someone sees them: "the toolbar along the top", "the list on the left", "the settings panel on the right". Name the buttons as the app labels them. ## Common tasks - What people ask for, then how: menu path, button, shortcut. Five to eight lines. - Export a file: File menu → Export… (⇧⌘E) → pick a format → Save. ## Pointing hints - "Where is export?" → point at the File menu, then Export…. - One line per frequent question: which control or area to point at. ## Gotchas - The traps: a panel that hides itself, a button that only appears after selecting something, a setting that lives somewhere surprising.