Ryan Malloy
32b41f79d9
Astro + Starlight documentation site for mcwaddams MCP server. Features: - Diátaxis documentation structure (tutorials, how-to, reference, explanation) - Office Space theming (Milton Waddams, TPS Reports, red Swingline) - 29 documentation pages covering all 20 tools - TPS Reports section for test results - Flair gamification config (pieces of documentation flair) - Custom CSS with Office Space color scheme Structure: - Getting Started: backstory, installation, quickstart - Tutorials: first extraction, legacy formats, indexing, resources - How-To: tables, Excel analysis, markdown, pagination, URLs - Reference: all tools, universal/word/excel tools, MCP resources, formats - Explanation: architecture, mixins, fallbacks, resource system - TPS Reports: dashboard, coverage, torture tests - Community: credits, feedback, leaderboard
32 lines
819 B
Plaintext
32 lines
819 B
Plaintext
---
|
|
title: Fallback Strategy
|
|
description: How mcwaddams tries multiple methods to extract your documents.
|
|
---
|
|
|
|
import { Aside } from '@astrojs/starlight/components';
|
|
|
|
# Fallback Strategy
|
|
|
|
> *"We fixed the glitch."*
|
|
|
|
When the primary extraction method fails, mcwaddams automatically tries alternatives.
|
|
|
|
## Fallback Chain
|
|
|
|
| Format | Primary | Fallback |
|
|
|--------|---------|----------|
|
|
| `.docx` | python-docx | mammoth |
|
|
| `.doc` | olefile | textract |
|
|
| `.xlsx` | openpyxl | pandas |
|
|
| `.xls` | xlrd | pandas |
|
|
|
|
## The Philosophy
|
|
|
|
1. **Try the best method first** — Usually works
|
|
2. **Fall back gracefully** — Alternative parsers step in
|
|
3. **Never silently fail** — Always return content or a clear error
|
|
|
|
<Aside type="note">
|
|
See [Architecture](/explanation/architecture/) for implementation details.
|
|
</Aside>
|