check-resources

You can validate documentation resources by running a dedicated linter that targets single-file and multi-file reviews to ensure consistent link descriptions and proper organization, generating a report of necessary changes.

Enforcing consistent formatting for documentation resource sections requires an automated validation process that targets link descriptions and organizational grouping, reducing review cycles and ensuring logical structure for reader navigability.

Yes, you can validate multiple markdown files simultaneously by passing file path patterns like `docs/**/*.mdx` to the linter, which performs multi-file reviews to ensure consistent link descriptions and proper organization across the entire documentation set.

Auto-fixing documentation resources offers two modes: an auto-fix mode that modifies files directly to apply corrections, and a report-only mode that surfaces necessary changes as a dry-run check without modifying the original files.

Documentation links fail formatting checks when they lack descriptive, action-oriented link text or proper context placement; running a validation linter identifies these structural issues and enforces organizational rules before the review cycle.

Limitations of linting tools for markdown resource sections include strict reliance on predefined formatting rules like AGENTS.md, meaning they enforce structural consistency and link descriptions rather than verifying if the external URLs themselves are live or resolving correctly.