fix-bp-docs

You can audit best-practices documentation by running a validation process that detects stale references, duplicates, and obsolete content. This ensures all rules are current and uniquely categorized across the documentation folder.

To fix broken links and formatting issues, apply validation and update steps that normalize formatting consistency across categories. This process preserves existing anchors while correcting invalid links and anchor IDs in the index file.

Yes, the documentation audit specifically applies to the Brave Core repository's docs/best-practices folder and the index file at docs/BEST-PRACTICES.md, handling duplicates and missing references across categories.

The best way to remove duplicates is to run an audit that checks for duplicate detection and cleanup across docs. This normalizes formatting and ensures unique categorization while preserving existing valid anchors.

Yes, you can update references without breaking anchors. The process implements validation steps for invalid links and anchor IDs while specifically preserving existing anchors and following project formatting conventions.

You should run a documentation audit when updating the BEST-PRACTICES.md index to ensure all rules are current and uniquely categorized. This removes obsolete content and resolves formatting inconsistencies across the folder.