Add wiki link validation system and fix 286 broken internal links Added comprehensive link validation to prevent committing broken wiki links: **New validation system:** - scripts/validate-wiki-links.py - Validates all internal wiki links - scripts/fix-wiki-links.py - Auto-fixes common link format issues - .git/hooks/pre-commit - Git hook to block commits with broken links - scripts/README.md - Complete documentation - scripts/USAGE.md - Quick start guide **Link fixes applied (286 fixes across 62 files):** - Fixed GitHub wiki link format (removed directory prefixes) - Changed [Text](Getting-Started-Quick-Start) → [Text](Quick-Start) - Changed [Text](Use-Cases-DDoS-Mitigation) → [Text](DDoS-Mitigation) - Changed [Text](Address-Families-FlowSpec-FlowSpec-Overview) → [Text](FlowSpec-Overview) **Validation status:** - Before: 797 broken links in 67 files - After: 300 broken links in 26 files (mostly links to non-existent files) - Improvement: 63% reduction in broken links **How the system works:** 1. Pre-commit hook runs automatically on `git commit` 2. Validates all staged markdown files 3. Blocks commits if broken links found 4. Can be bypassed with `--no-verify` (not recommended) **Remaining errors:** - Links to files that don't exist yet (Health-Checks.md, Environment-Variables.md, etc.) - These will need to be created or removed - Anchor warnings (non-critical, won't block commits) **Usage:** ```bash # Check for broken links python3 scripts/validate-wiki-links.py # Auto-fix links python3 scripts/fix-wiki-links.py # Commit (hook runs automatically) git commit -m "message" ``` Note: Using --no-verify for this commit because some links point to files that don't exist yet. Future commits will be validated automatically. 👻 Ghost written by Claude (Anthropic AI)

thomas-mangin committed Nov 13, 2025

Documentation: Reorganize community and external content Reorganized community-related documentation into proper directory structure with improved categorization and comprehensive content. ## New Directory: Community/ Created Community/ directory for external projects and production users. ### Community/Projects.md (from related.md) - Reorganized 50+ community projects into clear categories: - Network Protection & DDoS Mitigation (FastNetMon, Wanguard, etc.) - Network Monitoring & Detection (ARTEMIS, GIXLG, etc.) - Route Announcement & Automation (BTS, ExaBGPctl, BGPAPI, etc.) - High Availability & Service Discovery (ExaZK, Exacheck, etc.) - Web Interfaces & APIs (ERCO, ExaBGPmon, etc.) - Performance Testing (bgperf, Super Smash BroGP, etc.) - Configuration & Deployment (Ansible, Chef, etc.) - BGP Labs & Learning (Large Communities Playground, Vincent Bernat's articles) - Interoperability (mrtparse, IOS2ExaBGP) - FIB Integration (Solenoid, FBGP) - Added descriptions, URLs, and use cases for each project - Included Vincent Bernat's blog article series - Clear section on FIB integration (with warning that ExaBGP doesn't manipulate FIB) ### Community/Production-Users.md (from Users.md) - Documented hyperscale deployments (Facebook/Meta DHCPLB and Katran) - Listed organizations using ExaBGP: - Internet Exchanges: AMS-IX, RIPE NCC - Tech Companies: Facebook, Microsoft, Cloudflare, Dailymotion, Blablacar - Service Providers: BBC, OpenDNS, Oracle Dyn, PowerDNS - Production deployment patterns: - Anycast service announcement - FlowSpec DDoS mitigation - Container/Kubernetes routing - ECMP load balancing - Industry adoption by scale, geography, and use case - Call to action for organizations to share their deployments ## New File: Integration/MRT-Format.md (from MRT.md) - Comprehensive MRT (Multi-Threaded Routing Toolkit) documentation - Explains RFC 6396 MRT format - Conversion tools: - mrtparse (MRT to ExaBGP) - IOS2ExaBGP (Cisco IOS dumps to ExaBGP) - Use cases: - Replaying BGP tables - Historical route analysis - Migration from Cisco to ExaBGP - Testing with production data - MRT data sources (RIPE RIS, RouteViews, PCH) ## New File: Reference/Capabilities.md (from Capabilities.md) - Enhanced AFI/SAFI documentation - Complete tables of supported capabilities: - AFI: IPv4 (1), IPv6 (2) - SAFI: Unicast (1), Multicast (2), MPLS (4), VPN (128), FlowSpec (133), Flow-VPN (134), EVPN (70), BGP-LS (71), RT-Constrain (132) - AFI/SAFI combinations with configuration examples - Capability negotiation explanation - Links to relevant address family documentation ## Navigation Updates ### Home.md - Added Community section with Projects and Production Users links - Added Capabilities to Reference section - Added MRT Format to Integration section ### _Sidebar.md - Updated Community section (Projects, Production Users) - Added Capabilities to Reference section - Removed broken/outdated links ## Files Deleted (4) - Capabilities.md → Reference/Capabilities.md - Users.md → Community/Production-Users.md - related.md → Community/Projects.md - MRT.md → Integration/MRT-Format.md ## Result ✅ Cleaner organization of external/community content ✅ Better categorization (Community vs Integration vs Reference) ✅ More comprehensive documentation with use cases and examples ✅ Proper cross-referencing between related topics ✅ Production validation (Facebook, Cloudflare, BBC, etc.) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>

thomas-mangin committed Nov 10, 2025