Initial mcwaddams documentation site
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
This commit is contained in:
commit
32b41f79d9
42 changed files with 10513 additions and 0 deletions
31
src/content/docs/explanation/fallbacks.mdx
Normal file
31
src/content/docs/explanation/fallbacks.mdx
Normal file
|
|
@ -0,0 +1,31 @@
|
|||
---
|
||||
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>
|
||||
Loading…
Add table
Add a link
Reference in a new issue