fix-bp-docs

You can audit best practices documentation by scanning Markdown files to verify file paths, symbols, and links against source code directories, identifying stale references, duplicates, and formatting issues for correction.

Fixing broken file paths and duplicate rules involves scanning documentation directories to verify references against the actual source code structure, then flagging and correcting formatting inconsistencies and duplicates.

Validate documentation integrity by running the manage-bp-ids.py script with the --validate flag, which checks best practices Markdown files for formatting issues and reference accuracy against the codebase.

This documentation audit tool works specifically with Markdown files located in ./docs/best-practices/ and ./docs/BEST-PRACTICES.md within the brave-core repository, verifying them against the src/ directories.

Best practices documentation becomes outdated when code changes are not reflected in the docs, leading to stale file paths, broken internal links, and duplicate rules that require an automated audit to detect and fix.