Skip to main content

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​

SectionTarget Length
1. Purpose & Audience4-6 sentences
2. Key Metrics5-8 lines per metric, top 3-6 metrics
3. Filters & Interactivity1 table + 3-6 bullet points
4. How to Use8-15 lines
5. Data & Refresh4-8 lines
6. Design Health Summary5-8 lines (HARD CAP)
7. Glossary0-10 terms (omit if no jargon)