Skip to content

bamr87 Documentation

Link Health Management

Link Health Management¶

Mission: Maintain link integrity across all IT-Journey content to ensure seamless navigation and optimal user experience.

Quick Status¶

Metric	Value	Status
Total Links Scanned	-	Pending scan
Broken Links	-	Pending scan
Success Rate	-	Pending scan
Last Scan	Never	-

Directory Structure¶

TODO/links/
├── README.md              # This file - Central hub
├── QUICK_ACTIONS.md       # Prioritized fix tasks
├── TRACKING.md            # Progress tracking
├── data/
│   └── link-report.json   # Machine-readable scan results
└── reports/
    └── scan-YYYY-MM-DD.md # Historical scan reports

Key Files¶

File	Purpose	Update Frequency
QUICK_ACTIONS.md	Immediate fix tasks by priority	After each scan
TRACKING.md	Progress on link fixes	Weekly
data/link-report.json	Raw scan data for automation	After each scan

Link Categories¶

By Error Type¶

Category	Description	Priority
Internal 404s	Missing pages on it-journey.dev	Critical
External Broken	Third-party links that no longer work	High
Rate Limited	Links blocked during scanning (false positives)	Low
Timeouts	Slow external sites	Medium
SSL/Certificate	Security-related link issues	High

By Content Area¶

Area	Path	Typical Issues
Quests	`pages/_quests/`	Internal navigation, resource links
Posts	`pages/_posts/`	External references, outdated tutorials
Docs	`pages/_docs/`	API links, tool documentation
About	`pages/_about/`	Social links, contact pages

Workflow¶

Automated Scanning¶

The link checker runs automatically: - Scheduled: Every Monday at 6 AM UTC - Manual: Via GitHub Actions workflow dispatch

Fix Process¶

Review QUICK_ACTIONS.md for prioritized tasks
Fix critical internal links first
Update or remove broken external references
Mark completed items in tracking
Re-run scan to verify fixes

Running the Link Checker¶

Local Scan¶

# Full website scan
python3 scripts/validation/link-checker.py --scope website

# Scan specific content
python3 scripts/validation/link-checker.py --scope posts
python3 scripts/validation/link-checker.py --scope quests

# Quick scan with timeout
python3 scripts/validation/link-checker.py --scope website --timeout 15

GitHub Actions¶

Go to Actions > Link Health Guardian
Click "Run workflow"
Select scope and options
Review results in artifacts and this directory

Success Metrics¶

Metric	Target	Current
Success Rate	>95%	-
Internal 404s	0	-
Response Time	<48h for critical	-

TODO Hub - Central TODO directory
STATUS Dashboard - Overall project status
Link Checker Workflow - Automation config
Link Checker Script - Scan tool

Project Owner: IT-Journey Team Created: 2026-01-17 Last Updated: 2026-01-17 Status: Active