Auto-Doc Structures
Output templates and length targets for Brief and Detailed Auto-Doc documents.
Filter defaults, filter types, cross-filter behavior, drill paths, and refresh schedules are not available through the Tableau MCP. Describe only what is visible in the rendered image (mark it "(inferred from image)"); otherwise write "Not available via MCP; confirm with the owner".
Brief Auto-Doc Structure
Target: ~1 page. Designed for quick reference, stakeholder overviews, or embedding as a help tab.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[Dashboard Title] — Quick Reference
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Source: [Workbook] / [View] | Owner: [name]
Last Updated: [date] | Usage: [views count]
PURPOSE
[2-3 sentences: what this dashboard is for, who it's for,
what primary question it answers]
KEY METRICS
• [Metric 1]: [One-line definition] — [↑/↓/→ direction]
• [Metric 2]: [One-line definition] — [↑/↓/→ direction]
• [Metric 3]: [One-line definition] — [↑/↓/→ direction]
[List top 4-6 metrics, one line each]
FILTERS
• [Filter 1]: [What it controls]
• [Filter 2]: [What it controls]
HOW TO READ IT
[3-5 sentences: scan path, what to look at first,
what action to take if something looks off]
NOTES
• Data refreshes: [Not available via MCP; confirm with the owner]
• [1-2 key caveats or limitations]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Length target: 30-50 lines. Should fit on a single printed page.
Detailed Auto-Doc Structure
Target: 1.5-3 pages. Comprehensive reference documentation.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Dashboard Documentation — [Dashboard Title]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Generated by Tableau Scribe | [Date]
Source: [Workbook name] / [View name]
Owner: [from metadata] | Project: [from metadata]
Last Updated: [from metadata] | Usage: [hitsTotal] views
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. PURPOSE & AUDIENCE
Purpose: [What this dashboard is for — inferred from visible
content, title, metrics shown]
Primary question answered: "[The one question this dashboard
answers at a glance]"
Intended audience: [Inferred from complexity, filter count,
information density — Executive/Manager/Analyst/Operations]
Decisions supported:
- [Decision 1 this dashboard enables]
- [Decision 2]
- [Decision 3]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
2. KEY METRICS
For each visible KPI/metric:
[Metric Name]
- Definition: [Plain-language explanation]
- Business meaning: [Why this matters / what it tells you]
- Directionality: [Higher is better / Lower is better /
Context-dependent]
- Source field: [Datasource field, only if it clearly matches
in metadata; otherwise "(inferred)" or "confirm with owner"]
- Current value context: [Typical range or benchmark if available]
[Repeat for each metric]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
3. FILTERS & INTERACTIVITY
Available Filters:
| Filter | Type | Default Value | What It Controls |
|--------|------|---------------|-----------------|
| [Name] | [Dropdown/Date/Radio, if visible in image] | [Not available via MCP; confirm with the owner] | [Which charts, inferred from image or "confirm with owner"] |
Interactive Elements:
- [Click/hover behaviors visible in the image, marked "(inferred from image)"]
- [Cross-filtering relationships only if visible; otherwise omit]
- [Drill-down paths only if visible; otherwise omit]
Tips:
- [Practical guidance on using filters effectively]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
4. HOW TO USE THIS DASHBOARD
Reading the dashboard:
- Start at [top-left / KPI zone] — this shows [what]
- Then scan [primary chart area] — this answers [what question]
- Use [filters/interactions] to [narrow/explore/compare]
Common analysis paths:
- "Is performance on track?" → Check [KPI] → If [condition],
drill into [chart]
- "What's driving the trend?" → Look at [chart] → Filter by
[dimension]
What to look for:
- [Specific patterns or thresholds that indicate action needed]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
5. DATA & REFRESH
Data source: [Name, from metadata]
Refresh cadence: [Not available via MCP; confirm with the owner]
Data latency: [If timestamp visible in dashboard]
Known limitations:
- [Any visible caveats, date ranges, exclusions]
- [Fields that appear filtered or scoped]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
6. DESIGN HEALTH SUMMARY
Layout: [Clean/cluttered — brief note on hierarchy and scan path]
Accessibility: [Color usage, font legibility, any concerns]
Ethical flags: [Misleading scales, missing context, PII — or
"None identified"]
Overall impression: [1-2 sentences]
For full evaluation: "Run VizCritique Pro on this view for a
scored 7-domain review."
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
7. GLOSSARY (if applicable)
[Term]: [Definition]
[Only include if domain-specific jargon appears]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Detailed Auto-Doc Length Targets
| Section | Target Length |
|---|---|
| 1. Purpose & Audience | 4-6 sentences |
| 2. Key Metrics | 5-8 lines per metric, top 3-6 metrics |
| 3. Filters & Interactivity | 1 table + 3-6 bullet points |
| 4. How to Use | 8-15 lines |
| 5. Data & Refresh | 4-8 lines |
| 6. Design Health Summary | 5-8 lines (HARD CAP) |
| 7. Glossary | 0-10 terms (omit if no jargon) |