# Broken Links Fix Plan

**Last Updated:** 2026-01-20

## Overview

Plan for systematically fixing remaining broken links in documentation.

## Current Status

**Total Broken Links:** ~1,850 (from validation script)

**Fixed So Far:** 72 links (automated fixes)

**Remaining:** ~1,778 links

## Fix Strategy

### Phase 1: High-Impact Files ✅

**Priority Files:**
- `docs/DOCUMENTATION_MASTER_INDEX.md` - Master navigation
- `docs/README.md` - Root documentation index
- `docs/guides/README.md` - Guides index
- `docs/guides/comparison-pages/COMPARISON_PAGES_GUIDE.md` - Comparison pages guide
- `docs/guides/tools-pages/README.md` - Tools pages guide

**Status:** High-impact files checked, minimal broken links found

### Phase 2: Automated Fixes

**Common Patterns:**
- Missing `.md` extension
- Incorrect relative paths
- Archive file references
- Case sensitivity issues

**Tool:** `scripts/fix-common-link-issues.py`

### Phase 3: Manual Review

**For Remaining Links:**
- Review broken link reports
- Fix systematically by directory
- Update references to archived files
- Verify fixes with validation script

## Next Steps

1. **Run automated fixes** - Use `fix-common-link-issues.py` for common patterns
2. **Review high-impact files** - Fix broken links in master indexes
3. **Systematic directory review** - Fix links directory by directory
4. **Update archive references** - Point to archive locations or main files

## Related Documentation

- **[LINK_VALIDATION_REPORT.md](LINK_VALIDATION_REPORT.md)** - Complete broken links report
- **[fix-common-link-issues.py](../../scripts/fix-common-link-issues.py)** - Automated link fixing script
- **[validate-markdown-links.py](../../scripts/validate-markdown-links.py)** - Link validation script