Conceptual Models: How Users Think Products Work skill

A conceptual model is a mental representation of how something works.

by wondelai·MIT license·★ 2,235 Stars on the repo·GitHub ↗

Use now

Files of Conceptual Models: How Users Think Products Work

wondelai/main1 file
conceptual-models.md
Show the full text283 lines

Conceptual Models: How Users Think Products Work

A conceptual model is a mental representation of how something works. Users form conceptual models of every product they interact with, whether or not the designer intended a particular model. When the user's model matches reality, the product feels intuitive. When it does not, the product feels broken. The designer's most important job is shaping the system image so that users build correct mental models.

The Three Models

Design Model

The designer's understanding of how the product works. This model is complete and accurate because the designer built the system.

User's Model (Mental Model)

The user's understanding of how the product works. This model is often incomplete, simplified, and sometimes wrong. Users build their model from the system image, not from documentation or training.

System Image

Everything the product communicates to the user: its appearance, behavior, feedback, documentation, and responses. The system image is the only bridge between the design model and the user's model.

The Relationship
Designer ──creates──> Design Model
                          │
                     shapes the
                          │
                          v
                    System Image
                          │
                    perceived by
                          │
                          v
User ──builds──> User's Mental Model

The gap problem: Designers communicate with users only through the system image. If the system image is unclear, incomplete, or misleading, the user's model will diverge from the design model, and the product will feel confusing.

Why Models Matter
Alignment User Experience Example
Models match User predicts outcomes correctly, feels confident, recovers easily from mistakes User understands that "Trash" holds deleted files temporarily and can restore them
Models partially match User succeeds at basic tasks but fails at advanced ones User can send email but does not understand threading or labels
Models mismatch User is confused, frustrated, blames self, calls support User cranks thermostat to 90 expecting faster heating

Building Correct Conceptual Models

Principle 1: Make the System Visible

Users cannot model what they cannot see. Make internal states, processes, and structures visible.

Strategy Implementation Example
Show system state Persistent indicators "Connected", "Syncing", "Offline" badge
Show structure Visual hierarchy, navigation Folder tree showing file organization
Show process Step indicators, progress bars "Step 2 of 4: Payment"
Show relationships Visual grouping, connecting lines Org chart, dependency diagram
Show history Activity log, version history "Last edited by Alice, 2 hours ago"
Principle 2: Provide a Good Conceptual Framework

Give users a simple, accurate model they can reason with.

Strategy Implementation Example
Use familiar metaphors Map new concepts to known ones Desktop, folders, trash can, shopping cart
Offer a simplified model first Progressive complexity Basic view with "Show advanced options"
Explain behavior, not mechanism User-facing language "Your file is stored safely in the cloud" not "Uploaded to S3 bucket us-east-1"
Be consistent Same action always produces same result Click always selects, double-click always opens
Principle 3: Provide Feedback That Reinforces the Model

Every interaction should confirm or refine the user's understanding.

Strategy Implementation Example
Show cause and effect Animation connecting action to result Dragged file animates into folder
Confirm expectations Success messages that describe what happened "Your message was sent to 3 recipients"
Correct misunderstandings Helpful error messages "This action will delete the original, not create a copy"
Reveal hidden states Make the invisible visible Show "Background sync in progress" instead of syncing silently

Metaphor-Based Conceptual Models

Metaphors are the most powerful tool for building conceptual models. They let users apply existing knowledge to new systems.

Classic Software Metaphors
Metaphor Source Domain What It Maps What It Teaches
Desktop Office desk Screen is a workspace Organize items spatially, stack windows
Folders Filing cabinet Directory structure Hierarchical organization, nesting
Trash / Recycle Bin Physical waste bin Deletion holding area Deletion is two-phase: discard, then empty
Shopping cart Physical shopping cart Purchase collection Gather items, then checkout all at once
Inbox Physical mailbox Message arrival point New items arrive here, process and move them
Clipboard Physical clipboard Temporary storage Copy puts it on the clipboard, paste retrieves it
Bookmark Physical bookmark Saved location Mark a place to return to later
Dashboard Car dashboard Overview of key metrics At-a-glance status of important indicators
Why Metaphors Work
  1. Transfer of knowledge: Users already know how a physical shopping cart works. They apply that knowledge to the digital cart without instruction.
  2. Predictability: If trash works like physical trash, users expect they can retrieve items before the bin is emptied.
  3. Vocabulary: Metaphors provide a shared language. "Drag the file to the trash" is immediately understood.
  4. Constraints: Metaphors imply constraints. A folder contains things. A trash bin is for discarding.

When Metaphors Break Down

Every metaphor eventually reaches its limits. The digital domain does not perfectly mirror the physical domain, and extended metaphors can mislead users.

Metaphor Where It Breaks User Confusion
Desktop Unlimited windows, virtual desktops, no physical constraint Users lose windows behind other windows
Folders Files can exist in multiple locations (aliases, shortcuts, tags) "I moved the file, why is it still in the other folder?"
Trash Emptying trash is permanent; some systems auto-empty "I emptied the trash, can I get it back?"
Shopping cart Cart persists across sessions; items can sell out while in cart "I had it in my cart yesterday, now it's gone"
Save Auto-save means the floppy disk concept is obsolete "Where's the save button?" (It auto-saves.)
Cloud Implies floating, ephemeral; actually stored on physical servers "Where exactly is my data?"
Handling Metaphor Limits
  • Acknowledge the limit explicitly: "Unlike a physical folder, the same file can appear in multiple places."
  • Extend with new concepts: Introduce "tags" as a complement to folders when hierarchical metaphor breaks down.
  • Provide escape hatches: When the metaphor fails, provide a literal description. Show the actual file path alongside the metaphorical folder view.
  • Do not force the metaphor: If the metaphor creates confusion, drop it and use direct interaction instead.

Model Mismatch Diagnosis

When users struggle with a product, the cause is often a mismatch between their mental model and the system's actual behavior. Use this diagnostic process.

Step 1: Identify the Symptom
Symptom Likely Mismatch
User tries an action that does not exist Their model includes capabilities the system lacks
User cannot find a feature that exists Their model does not include the feature's location
User expects outcome A but gets outcome B Their model predicts different behavior than the system delivers
User repeats an action unnecessarily Their model does not include the system's automatic behavior (auto-save, sync)
User is afraid to act Their model does not include recovery options (undo, trash)
Step 2: Identify the User's Model

Ask (or infer from behavior):

  • "What did you expect to happen?"
  • "Where did you look for this feature?"
  • "How do you think [feature X] works?"
Step 3: Identify the Gap
Question Analysis
Is the system image unclear? The product does not communicate its behavior effectively
Is the metaphor misleading? The metaphor sets wrong expectations
Is the model too complex? The user simplified the model and lost critical detail
Is prior experience interfering? The user applies a model from a different product
Step 4: Fix the System Image
Gap Type Fix Strategy
Unclear system image Add signifiers, feedback, state indicators
Misleading metaphor Revise the metaphor, add explanatory text
Over-simplified model Progressive disclosure: teach complexity gradually
Prior product interference Onboarding that highlights "how we're different"

Progressive Model Building: Simple to Complex

Users should not need to understand the full system model before they can use it. Start with a simple model and reveal complexity as users need it.

Implementation Strategies
Strategy How It Works Example
Beginner mode / Advanced mode Two views of the same system Photo editor: basic adjustments vs. full curve controls
Layered settings Common settings visible, advanced settings collapsed "Show advanced options" expander
Contextual education Teach concepts when the user first encounters them Tooltip on first use: "Tags let you organize items without folders"
Graduated onboarding Introduce features across multiple sessions Day 1: core actions. Day 3: shortcuts. Day 7: advanced features.
Inline help Brief explanations embedded in the interface "?" icon next to complex settings, opening a brief explanation
The Progression
Simple Model ──use──> Encounter Edge Case ──learn──> Richer Model ──use──> Mastery
  • Simple model: "Delete moves items to Trash."
  • Edge case: "I emptied the Trash. Can I get something back?"
  • Richer model: "Trash is a 30-day holding period. After that, items are permanently removed. Premium users can recover items for 60 days."
  • Mastery: The user understands the full lifecycle and plans accordingly.

Conceptual Model Evaluation Techniques

Technique 1: Draw-and-Explain

Ask 5 users to draw how they think the system works (boxes, arrows, flow). Compare their drawings to the actual architecture. Where drawings diverge from reality, the system image is failing.

Technique 2: Prediction Test

Before performing an action, ask the user: "What do you think will happen when you click this?" If their prediction is wrong, their model is wrong. Identify what led to the incorrect prediction.

Technique 3: Teaching Test

Ask a user who has used the product for a week to explain it to a new user. Listen for:

  • Inaccurate explanations (model is wrong).
  • Missing concepts (model is incomplete).
  • Hedging ("I think it works like... but I'm not sure") (model is uncertain).
Technique 4: Error Analysis

Catalog the errors users make. Group them by the incorrect assumption that caused the error. Each assumption reveals a model mismatch.

Error Incorrect Assumption Model Fix
User tries to drag files between cloud accounts "My cloud drive works like a folder on my desktop" Show account boundaries clearly
User types a URL in the search bar "This text field is for navigating" Differentiate search and address bar visually
User closes a tab expecting it to save "Closing saves my work" Auto-save, or prompt before closing unsaved work

Conceptual Model Examples

The Thermostat
  • Designer's model: Set a target temperature. The system turns heating or cooling on/off to reach and maintain it. Setting a higher number does not make it heat faster.
  • Common user model: The thermostat is a valve. Higher number = more heat output = faster warming.
  • System image failure: Most thermostats show only the target number, not the rate of heating or the current mechanism (on/off). This allows the "valve" model to persist.
  • Fix: Show current temperature AND target temperature. Show "Heating to 72..." with an animated indicator. Show estimated time to reach target.
The File System
  • Designer's model: Hierarchical tree structure. Files have a single location. Shortcuts/aliases point to files but are not copies.
  • Common user model: "My documents are somewhere in the computer." Many users have no spatial model of file organization.
  • System image failure: File explorers show the tree but do not teach the concept of hierarchy. Path bars are technical. Search bypasses the model entirely.
  • Fix: Show breadcrumbs as a path. Animate navigation (zoom into folder). Show "You are here" in the tree. Use metaphor: "Like folders in a filing cabinet."
Version Control (Git)
  • Designer's model: A directed acyclic graph of snapshots with branches, merges, and remote references.
  • Common user model: "Save" with the ability to go back. Maybe: "a timeline of saves."
  • System image failure: Git's command-line interface exposes the full graph model with no simplification. Error messages reference concepts (detached HEAD, rebase, cherry-pick) that have no intuitive mapping.
  • Fix: Visual branch diagrams, simplified workflows ("save point" instead of "commit"), and hiding advanced graph operations behind explicit expert mode.
Cloud Storage
  • Designer's model: Files stored on remote servers, synchronized across devices with conflict resolution.
  • Common user model: "My files are in the cloud" (vague). Some users: "The cloud IS my computer's folder."
  • System image failure: Sync status is often hidden. Conflict resolution happens silently or with cryptic duplicate filenames.
  • Fix: Show sync status per file (synced, syncing, conflict). Explain conflicts in plain language: "This file was edited on two devices. Which version do you want to keep?"

Teaching Users Correct Models Through Design

Do Not Rely on Documentation

Users do not read manuals, help pages, or knowledge bases before using a product. The product itself must teach its model.

Techniques for In-Product Education
Technique When to Use Example
Onboarding tour First-time use Highlight key areas, explain core concepts in 3-5 steps
Empty states No content yet "You have no projects yet. Create one to get started." with illustration showing the concept
Inline hints First encounter with a feature "Tip: Drag columns to reorder them" shown once, then dismissed
Animated transitions State changes File animates from inbox to archive, teaching the user where it went
Consistent patterns Everywhere When every list behaves the same way, users generalize from one to all
Error messages as teaching On mistakes "You cannot delete a folder that contains files. Move or delete the files first." teaches hierarchy
Progressive disclosure Complexity management Show basic model first, reveal advanced model on demand
The Golden Rule of Model Teaching

Show, do not tell. An animation of a file moving to the trash teaches more than a paragraph of text explaining deletion. An inline preview of formatting teaches more than a formatting guide. Let users experience the model through interaction.

1# Conceptual Models: How Users Think Products Work
2 
3A conceptual model is a mental representation of how something works. Users form conceptual models of every product they interact with, whether or not the designer intended a particular model. When the user's model matches reality, the product feels intuitive. When it does not, the product feels broken. The designer's most important job is shaping the system image so that users build correct mental models.
4 
5## The Three Models
6 
7### Design Model
8 
9The designer's understanding of how the product works. This model is complete and accurate because the designer built the system.
10 
11### User's Model (Mental Model)
12 
13The user's understanding of how the product works. This model is often incomplete, simplified, and sometimes wrong. Users build their model from the system image, not from documentation or training.
14 
15### System Image
16 
17Everything the product communicates to the user: its appearance, behavior, feedback, documentation, and responses. The system image is the only bridge between the design model and the user's model.
18 
19### The Relationship
20 
21```
22Designer ──creates──> Design Model
23 │
24 shapes the
25 │
26 v
27 System Image
28 │
29 perceived by
30 │
31 v
32User ──builds──> User's Mental Model
33```
34 
35**The gap problem**: Designers communicate with users only through the system image. If the system image is unclear, incomplete, or misleading, the user's model will diverge from the design model, and the product will feel confusing.
36 
37### Why Models Matter
38 
39| Alignment | User Experience | Example |
40|-----------|----------------|---------|
41| Models match | User predicts outcomes correctly, feels confident, recovers easily from mistakes | User understands that "Trash" holds deleted files temporarily and can restore them |
42| Models partially match | User succeeds at basic tasks but fails at advanced ones | User can send email but does not understand threading or labels |
43| Models mismatch | User is confused, frustrated, blames self, calls support | User cranks thermostat to 90 expecting faster heating |
44 
45---
46 
47## Building Correct Conceptual Models
48 
49### Principle 1: Make the System Visible
50 
51Users cannot model what they cannot see. Make internal states, processes, and structures visible.
52 
53| Strategy | Implementation | Example |
54|----------|---------------|---------|
55| Show system state | Persistent indicators | "Connected", "Syncing", "Offline" badge |
56| Show structure | Visual hierarchy, navigation | Folder tree showing file organization |
57| Show process | Step indicators, progress bars | "Step 2 of 4: Payment" |
58| Show relationships | Visual grouping, connecting lines | Org chart, dependency diagram |
59| Show history | Activity log, version history | "Last edited by Alice, 2 hours ago" |
60 
61### Principle 2: Provide a Good Conceptual Framework
62 
63Give users a simple, accurate model they can reason with.
64 
65| Strategy | Implementation | Example |
66|----------|---------------|---------|
67| Use familiar metaphors | Map new concepts to known ones | Desktop, folders, trash can, shopping cart |
68| Offer a simplified model first | Progressive complexity | Basic view with "Show advanced options" |
69| Explain behavior, not mechanism | User-facing language | "Your file is stored safely in the cloud" not "Uploaded to S3 bucket us-east-1" |
70| Be consistent | Same action always produces same result | Click always selects, double-click always opens |
71 
72### Principle 3: Provide Feedback That Reinforces the Model
73 
74Every interaction should confirm or refine the user's understanding.
75 
76| Strategy | Implementation | Example |
77|----------|---------------|---------|
78| Show cause and effect | Animation connecting action to result | Dragged file animates into folder |
79| Confirm expectations | Success messages that describe what happened | "Your message was sent to 3 recipients" |
80| Correct misunderstandings | Helpful error messages | "This action will delete the original, not create a copy" |
81| Reveal hidden states | Make the invisible visible | Show "Background sync in progress" instead of syncing silently |
82 
83---
84 
85## Metaphor-Based Conceptual Models
86 
87Metaphors are the most powerful tool for building conceptual models. They let users apply existing knowledge to new systems.
88 
89### Classic Software Metaphors
90 
91| Metaphor | Source Domain | What It Maps | What It Teaches |
92|----------|-------------|-------------|----------------|
93| **Desktop** | Office desk | Screen is a workspace | Organize items spatially, stack windows |
94| **Folders** | Filing cabinet | Directory structure | Hierarchical organization, nesting |
95| **Trash / Recycle Bin** | Physical waste bin | Deletion holding area | Deletion is two-phase: discard, then empty |
96| **Shopping cart** | Physical shopping cart | Purchase collection | Gather items, then checkout all at once |
97| **Inbox** | Physical mailbox | Message arrival point | New items arrive here, process and move them |
98| **Clipboard** | Physical clipboard | Temporary storage | Copy puts it on the clipboard, paste retrieves it |
99| **Bookmark** | Physical bookmark | Saved location | Mark a place to return to later |
100| **Dashboard** | Car dashboard | Overview of key metrics | At-a-glance status of important indicators |
101 
102### Why Metaphors Work
103 
1041. **Transfer of knowledge**: Users already know how a physical shopping cart works. They apply that knowledge to the digital cart without instruction.
1052. **Predictability**: If trash works like physical trash, users expect they can retrieve items before the bin is emptied.
1063. **Vocabulary**: Metaphors provide a shared language. "Drag the file to the trash" is immediately understood.
1074. **Constraints**: Metaphors imply constraints. A folder contains things. A trash bin is for discarding.
108 
109---
110 
111## When Metaphors Break Down
112 
113Every metaphor eventually reaches its limits. The digital domain does not perfectly mirror the physical domain, and extended metaphors can mislead users.
114 
115| Metaphor | Where It Breaks | User Confusion |
116|----------|----------------|---------------|
117| **Desktop** | Unlimited windows, virtual desktops, no physical constraint | Users lose windows behind other windows |
118| **Folders** | Files can exist in multiple locations (aliases, shortcuts, tags) | "I moved the file, why is it still in the other folder?" |
119| **Trash** | Emptying trash is permanent; some systems auto-empty | "I emptied the trash, can I get it back?" |
120| **Shopping cart** | Cart persists across sessions; items can sell out while in cart | "I had it in my cart yesterday, now it's gone" |
121| **Save** | Auto-save means the floppy disk concept is obsolete | "Where's the save button?" (It auto-saves.) |
122| **Cloud** | Implies floating, ephemeral; actually stored on physical servers | "Where exactly is my data?" |
123 
124### Handling Metaphor Limits
125 
126- **Acknowledge the limit explicitly**: "Unlike a physical folder, the same file can appear in multiple places."
127- **Extend with new concepts**: Introduce "tags" as a complement to folders when hierarchical metaphor breaks down.
128- **Provide escape hatches**: When the metaphor fails, provide a literal description. Show the actual file path alongside the metaphorical folder view.
129- **Do not force the metaphor**: If the metaphor creates confusion, drop it and use direct interaction instead.
130 
131---
132 
133## Model Mismatch Diagnosis
134 
135When users struggle with a product, the cause is often a mismatch between their mental model and the system's actual behavior. Use this diagnostic process.
136 
137### Step 1: Identify the Symptom
138 
139| Symptom | Likely Mismatch |
140|---------|----------------|
141| User tries an action that does not exist | Their model includes capabilities the system lacks |
142| User cannot find a feature that exists | Their model does not include the feature's location |
143| User expects outcome A but gets outcome B | Their model predicts different behavior than the system delivers |
144| User repeats an action unnecessarily | Their model does not include the system's automatic behavior (auto-save, sync) |
145| User is afraid to act | Their model does not include recovery options (undo, trash) |
146 
147### Step 2: Identify the User's Model
148 
149Ask (or infer from behavior):
150- "What did you expect to happen?"
151- "Where did you look for this feature?"
152- "How do you think [feature X] works?"
153 
154### Step 3: Identify the Gap
155 
156| Question | Analysis |
157|----------|---------|
158| Is the system image unclear? | The product does not communicate its behavior effectively |
159| Is the metaphor misleading? | The metaphor sets wrong expectations |
160| Is the model too complex? | The user simplified the model and lost critical detail |
161| Is prior experience interfering? | The user applies a model from a different product |
162 
163### Step 4: Fix the System Image
164 
165| Gap Type | Fix Strategy |
166|----------|-------------|
167| Unclear system image | Add signifiers, feedback, state indicators |
168| Misleading metaphor | Revise the metaphor, add explanatory text |
169| Over-simplified model | Progressive disclosure: teach complexity gradually |
170| Prior product interference | Onboarding that highlights "how we're different" |
171 
172---
173 
174## Progressive Model Building: Simple to Complex
175 
176Users should not need to understand the full system model before they can use it. Start with a simple model and reveal complexity as users need it.
177 
178### Implementation Strategies
179 
180| Strategy | How It Works | Example |
181|----------|-------------|---------|
182| **Beginner mode / Advanced mode** | Two views of the same system | Photo editor: basic adjustments vs. full curve controls |
183| **Layered settings** | Common settings visible, advanced settings collapsed | "Show advanced options" expander |
184| **Contextual education** | Teach concepts when the user first encounters them | Tooltip on first use: "Tags let you organize items without folders" |
185| **Graduated onboarding** | Introduce features across multiple sessions | Day 1: core actions. Day 3: shortcuts. Day 7: advanced features. |
186| **Inline help** | Brief explanations embedded in the interface | "?" icon next to complex settings, opening a brief explanation |
187 
188### The Progression
189 
190```
191Simple Model ──use──> Encounter Edge Case ──learn──> Richer Model ──use──> Mastery
192```
193 
194- **Simple model**: "Delete moves items to Trash."
195- **Edge case**: "I emptied the Trash. Can I get something back?"
196- **Richer model**: "Trash is a 30-day holding period. After that, items are permanently removed. Premium users can recover items for 60 days."
197- **Mastery**: The user understands the full lifecycle and plans accordingly.
198 
199---
200 
201## Conceptual Model Evaluation Techniques
202 
203### Technique 1: Draw-and-Explain
204 
205Ask 5 users to draw how they think the system works (boxes, arrows, flow). Compare their drawings to the actual architecture. Where drawings diverge from reality, the system image is failing.
206 
207### Technique 2: Prediction Test
208 
209Before performing an action, ask the user: "What do you think will happen when you click this?" If their prediction is wrong, their model is wrong. Identify what led to the incorrect prediction.
210 
211### Technique 3: Teaching Test
212 
213Ask a user who has used the product for a week to explain it to a new user. Listen for:
214- Inaccurate explanations (model is wrong).
215- Missing concepts (model is incomplete).
216- Hedging ("I think it works like... but I'm not sure") (model is uncertain).
217 
218### Technique 4: Error Analysis
219 
220Catalog the errors users make. Group them by the incorrect assumption that caused the error. Each assumption reveals a model mismatch.
221 
222| Error | Incorrect Assumption | Model Fix |
223|-------|---------------------|----------|
224| User tries to drag files between cloud accounts | "My cloud drive works like a folder on my desktop" | Show account boundaries clearly |
225| User types a URL in the search bar | "This text field is for navigating" | Differentiate search and address bar visually |
226| User closes a tab expecting it to save | "Closing saves my work" | Auto-save, or prompt before closing unsaved work |
227 
228---
229 
230## Conceptual Model Examples
231 
232### The Thermostat
233 
234- **Designer's model**: Set a target temperature. The system turns heating or cooling on/off to reach and maintain it. Setting a higher number does not make it heat faster.
235- **Common user model**: The thermostat is a valve. Higher number = more heat output = faster warming.
236- **System image failure**: Most thermostats show only the target number, not the rate of heating or the current mechanism (on/off). This allows the "valve" model to persist.
237- **Fix**: Show current temperature AND target temperature. Show "Heating to 72..." with an animated indicator. Show estimated time to reach target.
238 
239### The File System
240 
241- **Designer's model**: Hierarchical tree structure. Files have a single location. Shortcuts/aliases point to files but are not copies.
242- **Common user model**: "My documents are somewhere in the computer." Many users have no spatial model of file organization.
243- **System image failure**: File explorers show the tree but do not teach the concept of hierarchy. Path bars are technical. Search bypasses the model entirely.
244- **Fix**: Show breadcrumbs as a path. Animate navigation (zoom into folder). Show "You are here" in the tree. Use metaphor: "Like folders in a filing cabinet."
245 
246### Version Control (Git)
247 
248- **Designer's model**: A directed acyclic graph of snapshots with branches, merges, and remote references.
249- **Common user model**: "Save" with the ability to go back. Maybe: "a timeline of saves."
250- **System image failure**: Git's command-line interface exposes the full graph model with no simplification. Error messages reference concepts (detached HEAD, rebase, cherry-pick) that have no intuitive mapping.
251- **Fix**: Visual branch diagrams, simplified workflows ("save point" instead of "commit"), and hiding advanced graph operations behind explicit expert mode.
252 
253### Cloud Storage
254 
255- **Designer's model**: Files stored on remote servers, synchronized across devices with conflict resolution.
256- **Common user model**: "My files are in the cloud" (vague). Some users: "The cloud IS my computer's folder."
257- **System image failure**: Sync status is often hidden. Conflict resolution happens silently or with cryptic duplicate filenames.
258- **Fix**: Show sync status per file (synced, syncing, conflict). Explain conflicts in plain language: "This file was edited on two devices. Which version do you want to keep?"
259 
260---
261 
262## Teaching Users Correct Models Through Design
263 
264### Do Not Rely on Documentation
265 
266Users do not read manuals, help pages, or knowledge bases before using a product. The product itself must teach its model.
267 
268### Techniques for In-Product Education
269 
270| Technique | When to Use | Example |
271|-----------|-------------|---------|
272| **Onboarding tour** | First-time use | Highlight key areas, explain core concepts in 3-5 steps |
273| **Empty states** | No content yet | "You have no projects yet. Create one to get started." with illustration showing the concept |
274| **Inline hints** | First encounter with a feature | "Tip: Drag columns to reorder them" shown once, then dismissed |
275| **Animated transitions** | State changes | File animates from inbox to archive, teaching the user where it went |
276| **Consistent patterns** | Everywhere | When every list behaves the same way, users generalize from one to all |
277| **Error messages as teaching** | On mistakes | "You cannot delete a folder that contains files. Move or delete the files first." teaches hierarchy |
278| **Progressive disclosure** | Complexity management | Show basic model first, reveal advanced model on demand |
279 
280### The Golden Rule of Model Teaching
281 
282**Show, do not tell.** An animation of a file moving to the trash teaches more than a paragraph of text explaining deletion. An inline preview of formatting teaches more than a formatting guide. Let users experience the model through interaction.
283 

Discussion