[{"data":1,"prerenderedAt":62},["Reactive",2],{"blog-post-markdown-content-validation-automated-quality-assurance":3},{"slug":4,"title":5,"description":6,"excerpt":7,"date":8,"category":9,"author":10,"keywords":11,"readingMinutes":12,"html":13,"headings":14,"tools":37,"related":38},"markdown-content-validation-automated-quality-assurance","Markdown Content Validation and Automated Quality Assurance: Complete Guide for Documentation Excellence and Team Workflows","Master automated Markdown content validation with comprehensive quality assurance systems. Learn validation rules, automated testing, CI/CD integration, and quality metrics for professional documentation workflows.","Automated Markdown content validation and quality assurance systems enable professional documentation teams to maintain consistency, accuracy, and excellence across large content repositories…","2025-10-11","Tutorial","Matthew Rathbone","markdown validation, content quality assurance, automated markdown testing, documentation QA, markdown linting, content validation tools, documentation quality metrics, markdown CI/CD",27,"\u003Cp>Automated Markdown content validation and quality assurance systems enable professional documentation teams to maintain consistency, accuracy, and excellence across large content repositories while reducing manual review overhead and ensuring compliance with organizational standards. By implementing comprehensive validation workflows, automated testing pipelines, and quality metrics dashboards, technical teams can scale documentation processes without sacrificing content quality or user experience.\u003C/p>\n\u003Ch2 id=\"why-master-automated-content-validation\">Why Master Automated Content Validation?\u003C/h2>\n\u003Cp>Professional content validation provides essential benefits for documentation workflows:\u003C/p>\n\u003Cul>\n\u003Cli>\u003Cstrong>Consistency Enforcement\u003C/strong>: Automatically ensure adherence to style guides, formatting standards, and organizational conventions\u003C/li>\n\u003Cli>\u003Cstrong>Error Prevention\u003C/strong>: Catch syntax errors, broken links, missing metadata, and content issues before publication\u003C/li>\n\u003Cli>\u003Cstrong>Quality Metrics\u003C/strong>: Track documentation health through automated scoring, readability analysis, and compliance measurement  \u003C/li>\n\u003Cli>\u003Cstrong>Team Scalability\u003C/strong>: Enable distributed teams to contribute while maintaining unified quality standards\u003C/li>\n\u003Cli>\u003Cstrong>Continuous Improvement\u003C/strong>: Identify patterns in content issues to refine processes and improve documentation systems\u003C/li>\n\u003C/ul>\n\u003Ch2 id=\"foundation-validation-systems\">Foundation Validation Systems\u003C/h2>\n\u003Ch3 id=\"core-content-validation-framework\">Core Content Validation Framework\u003C/h3>\n\u003Cp>Building comprehensive validation systems for Markdown documentation:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-python\">\u003Cspan class=\"hljs-comment\"># markdown_validator.py - Comprehensive content validation system\u003C/span>\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> re\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> os\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> yaml\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> json\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> requests\n\u003Cspan class=\"hljs-keyword\">from\u003C/span> pathlib \u003Cspan class=\"hljs-keyword\">import\u003C/span> Path\n\u003Cspan class=\"hljs-keyword\">from\u003C/span> typing \u003Cspan class=\"hljs-keyword\">import\u003C/span> \u003Cspan class=\"hljs-type\">Dict\u003C/span>, \u003Cspan class=\"hljs-type\">List\u003C/span>, \u003Cspan class=\"hljs-type\">Optional\u003C/span>, \u003Cspan class=\"hljs-type\">Tuple\u003C/span>, \u003Cspan class=\"hljs-type\">Any\u003C/span>\n\u003Cspan class=\"hljs-keyword\">from\u003C/span> dataclasses \u003Cspan class=\"hljs-keyword\">import\u003C/span> dataclass\n\u003Cspan class=\"hljs-keyword\">from\u003C/span> enum \u003Cspan class=\"hljs-keyword\">import\u003C/span> Enum\n\u003Cspan class=\"hljs-keyword\">from\u003C/span> urllib.parse \u003Cspan class=\"hljs-keyword\">import\u003C/span> urlparse, urljoin\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> subprocess\n\u003Cspan class=\"hljs-keyword\">from\u003C/span> datetime \u003Cspan class=\"hljs-keyword\">import\u003C/span> datetime, timedelta\n\n\u003Cspan class=\"hljs-keyword\">class\u003C/span> \u003Cspan class=\"hljs-title class_\">ValidationSeverity\u003C/span>(\u003Cspan class=\"hljs-title class_ inherited__\">Enum\u003C/span>):\n    ERROR = \u003Cspan class=\"hljs-string\">"error"\u003C/span>\n    WARNING = \u003Cspan class=\"hljs-string\">"warning"\u003C/span>\n    INFO = \u003Cspan class=\"hljs-string\">"info"\u003C/span>\n\n\u003Cspan class=\"hljs-meta\">@dataclass\u003C/span>\n\u003Cspan class=\"hljs-keyword\">class\u003C/span> \u003Cspan class=\"hljs-title class_\">ValidationResult\u003C/span>:\n    rule_id: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\n    severity: ValidationSeverity\n    message: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\n    file_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\n    line_number: \u003Cspan class=\"hljs-type\">Optional\u003C/span>[\u003Cspan class=\"hljs-built_in\">int\u003C/span>] = \u003Cspan class=\"hljs-literal\">None\u003C/span>\n    column: \u003Cspan class=\"hljs-type\">Optional\u003C/span>[\u003Cspan class=\"hljs-built_in\">int\u003C/span>] = \u003Cspan class=\"hljs-literal\">None\u003C/span>\n    context: \u003Cspan class=\"hljs-type\">Optional\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>] = \u003Cspan class=\"hljs-literal\">None\u003C/span>\n    fix_suggestion: \u003Cspan class=\"hljs-type\">Optional\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>] = \u003Cspan class=\"hljs-literal\">None\u003C/span>\n\n\u003Cspan class=\"hljs-keyword\">class\u003C/span> \u003Cspan class=\"hljs-title class_\">ContentValidator\u003C/span>:\n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">__init__\u003C/span>(\u003Cspan class=\"hljs-params\">self, config_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span> = \u003Cspan class=\"hljs-string\">"validation_config.yaml"\u003C/span>\u003C/span>):\n        self.config = self.load_config(config_path)\n        self.results = []\n        self.file_cache = {}\n        \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">load_config\u003C/span>(\u003Cspan class=\"hljs-params\">self, config_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\u003C/span>) -> \u003Cspan class=\"hljs-type\">Dict\u003C/span>:\n        \u003Cspan class=\"hljs-string\">"""Load validation configuration from YAML file"""\u003C/span>\n        default_config = {\n            \u003Cspan class=\"hljs-string\">'rules'\u003C/span>: {\n                \u003Cspan class=\"hljs-string\">'frontmatter'\u003C/span>: {\n                    \u003Cspan class=\"hljs-string\">'enabled'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'required_fields'\u003C/span>: [\u003Cspan class=\"hljs-string\">'title'\u003C/span>, \u003Cspan class=\"hljs-string\">'description'\u003C/span>, \u003Cspan class=\"hljs-string\">'date'\u003C/span>, \u003Cspan class=\"hljs-string\">'author'\u003C/span>],\n                    \u003Cspan class=\"hljs-string\">'optional_fields'\u003C/span>: [\u003Cspan class=\"hljs-string\">'keywords'\u003C/span>, \u003Cspan class=\"hljs-string\">'category'\u003C/span>, \u003Cspan class=\"hljs-string\">'tags'\u003C/span>],\n                    \u003Cspan class=\"hljs-string\">'date_format'\u003C/span>: \u003Cspan class=\"hljs-string\">'%Y-%m-%d'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'title_max_length'\u003C/span>: \u003Cspan class=\"hljs-number\">100\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'description_max_length'\u003C/span>: \u003Cspan class=\"hljs-number\">200\u003C/span>\n                },\n                \u003Cspan class=\"hljs-string\">'headings'\u003C/span>: {\n                    \u003Cspan class=\"hljs-string\">'enabled'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'require_h1'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'max_heading_length'\u003C/span>: \u003Cspan class=\"hljs-number\">80\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'no_duplicate_headings'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'heading_case'\u003C/span>: \u003Cspan class=\"hljs-string\">'title'\u003C/span>,  \u003Cspan class=\"hljs-comment\"># title, sentence, lower, upper\u003C/span>\n                    \u003Cspan class=\"hljs-string\">'no_empty_headings'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>\n                },\n                \u003Cspan class=\"hljs-string\">'links'\u003C/span>: {\n                    \u003Cspan class=\"hljs-string\">'enabled'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'check_external'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'check_internal'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'allow_fragments'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'timeout'\u003C/span>: \u003Cspan class=\"hljs-number\">10\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'retry_count'\u003C/span>: \u003Cspan class=\"hljs-number\">2\u003C/span>\n                },\n                \u003Cspan class=\"hljs-string\">'images'\u003C/span>: {\n                    \u003Cspan class=\"hljs-string\">'enabled'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'require_alt_text'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'max_size_mb'\u003C/span>: \u003Cspan class=\"hljs-number\">5\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'allowed_formats'\u003C/span>: [\u003Cspan class=\"hljs-string\">'jpg'\u003C/span>, \u003Cspan class=\"hljs-string\">'jpeg'\u003C/span>, \u003Cspan class=\"hljs-string\">'png'\u003C/span>, \u003Cspan class=\"hljs-string\">'gif'\u003C/span>, \u003Cspan class=\"hljs-string\">'webp'\u003C/span>, \u003Cspan class=\"hljs-string\">'svg'\u003C/span>],\n                    \u003Cspan class=\"hljs-string\">'check_dimensions'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'min_width'\u003C/span>: \u003Cspan class=\"hljs-number\">200\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'max_width'\u003C/span>: \u003Cspan class=\"hljs-number\">2000\u003C/span>\n                },\n                \u003Cspan class=\"hljs-string\">'content'\u003C/span>: {\n                    \u003Cspan class=\"hljs-string\">'enabled'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'min_word_count'\u003C/span>: \u003Cspan class=\"hljs-number\">100\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'max_line_length'\u003C/span>: \u003Cspan class=\"hljs-number\">120\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'no_trailing_whitespace'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'consistent_list_markers'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'require_blank_lines'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>\n                },\n                \u003Cspan class=\"hljs-string\">'code_blocks'\u003C/span>: {\n                    \u003Cspan class=\"hljs-string\">'enabled'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'require_language_tags'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'validate_syntax'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'max_line_length'\u003C/span>: \u003Cspan class=\"hljs-number\">100\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'no_hardcoded_secrets'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>\n                },\n                \u003Cspan class=\"hljs-string\">'accessibility'\u003C/span>: {\n                    \u003Cspan class=\"hljs-string\">'enabled'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'heading_hierarchy'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'link_text_descriptive'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'table_headers'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'color_contrast_warnings'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>\n                }\n            },\n            \u003Cspan class=\"hljs-string\">'file_patterns'\u003C/span>: {\n                \u003Cspan class=\"hljs-string\">'include'\u003C/span>: [\u003Cspan class=\"hljs-string\">'**/*.md'\u003C/span>, \u003Cspan class=\"hljs-string\">'**/*.markdown'\u003C/span>],\n                \u003Cspan class=\"hljs-string\">'exclude'\u003C/span>: [\u003Cspan class=\"hljs-string\">'node_modules/**'\u003C/span>, \u003Cspan class=\"hljs-string\">'.git/**'\u003C/span>, \u003Cspan class=\"hljs-string\">'_site/**'\u003C/span>, \u003Cspan class=\"hljs-string\">'vendor/**'\u003C/span>]\n            },\n            \u003Cspan class=\"hljs-string\">'output'\u003C/span>: {\n                \u003Cspan class=\"hljs-string\">'format'\u003C/span>: \u003Cspan class=\"hljs-string\">'json'\u003C/span>,  \u003Cspan class=\"hljs-comment\"># json, junit, checkstyle, sarif\u003C/span>\n                \u003Cspan class=\"hljs-string\">'file'\u003C/span>: \u003Cspan class=\"hljs-string\">'validation_results.json'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'console'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'details'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>\n            }\n        }\n        \n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> os.path.exists(config_path):\n            \u003Cspan class=\"hljs-keyword\">with\u003C/span> \u003Cspan class=\"hljs-built_in\">open\u003C/span>(config_path, \u003Cspan class=\"hljs-string\">'r'\u003C/span>) \u003Cspan class=\"hljs-keyword\">as\u003C/span> f:\n                user_config = yaml.safe_load(f)\n                \u003Cspan class=\"hljs-comment\"># Merge with default config\u003C/span>\n                \u003Cspan class=\"hljs-keyword\">return\u003C/span> self.deep_merge(default_config, user_config)\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> default_config\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">deep_merge\u003C/span>(\u003Cspan class=\"hljs-params\">self, base: \u003Cspan class=\"hljs-type\">Dict\u003C/span>, override: \u003Cspan class=\"hljs-type\">Dict\u003C/span>\u003C/span>) -> \u003Cspan class=\"hljs-type\">Dict\u003C/span>:\n        \u003Cspan class=\"hljs-string\">"""Deep merge configuration dictionaries"""\u003C/span>\n        result = base.copy()\n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> key, value \u003Cspan class=\"hljs-keyword\">in\u003C/span> override.items():\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> key \u003Cspan class=\"hljs-keyword\">in\u003C/span> result \u003Cspan class=\"hljs-keyword\">and\u003C/span> \u003Cspan class=\"hljs-built_in\">isinstance\u003C/span>(result[key], \u003Cspan class=\"hljs-built_in\">dict\u003C/span>) \u003Cspan class=\"hljs-keyword\">and\u003C/span> \u003Cspan class=\"hljs-built_in\">isinstance\u003C/span>(value, \u003Cspan class=\"hljs-built_in\">dict\u003C/span>):\n                result[key] = self.deep_merge(result[key], value)\n            \u003Cspan class=\"hljs-keyword\">else\u003C/span>:\n                result[key] = value\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> result\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">validate_file\u003C/span>(\u003Cspan class=\"hljs-params\">self, file_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\u003C/span>) -> \u003Cspan class=\"hljs-type\">List\u003C/span>[ValidationResult]:\n        \u003Cspan class=\"hljs-string\">"""Validate a single Markdown file"""\u003C/span>\n        self.results = []\n        \n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> os.path.exists(file_path):\n            self.results.append(ValidationResult(\n                rule_id=\u003Cspan class=\"hljs-string\">'file_exists'\u003C/span>,\n                severity=ValidationSeverity.ERROR,\n                message=\u003Cspan class=\"hljs-string\">f'File does not exist: \u003Cspan class=\"hljs-subst\">{file_path}\u003C/span>'\u003C/span>,\n                file_path=file_path\n            ))\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span> self.results\n        \n        \u003Cspan class=\"hljs-comment\"># Read and cache file content\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">with\u003C/span> \u003Cspan class=\"hljs-built_in\">open\u003C/span>(file_path, \u003Cspan class=\"hljs-string\">'r'\u003C/span>, encoding=\u003Cspan class=\"hljs-string\">'utf-8'\u003C/span>) \u003Cspan class=\"hljs-keyword\">as\u003C/span> f:\n            content = f.read()\n            lines = content.split(\u003Cspan class=\"hljs-string\">'\\n'\u003C/span>)\n        \n        self.file_cache[file_path] = {\u003Cspan class=\"hljs-string\">'content'\u003C/span>: content, \u003Cspan class=\"hljs-string\">'lines'\u003C/span>: lines}\n        \n        \u003Cspan class=\"hljs-comment\"># Run validation rules\u003C/span>\n        self.validate_frontmatter(file_path, content, lines)\n        self.validate_headings(file_path, content, lines)\n        self.validate_links(file_path, content, lines)\n        self.validate_images(file_path, content, lines)\n        self.validate_content_structure(file_path, content, lines)\n        self.validate_code_blocks(file_path, content, lines)\n        self.validate_accessibility(file_path, content, lines)\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> self.results\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">validate_frontmatter\u003C/span>(\u003Cspan class=\"hljs-params\">self, file_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, content: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, lines: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>]\u003C/span>):\n        \u003Cspan class=\"hljs-string\">"""Validate YAML frontmatter"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'frontmatter'\u003C/span>][\u003Cspan class=\"hljs-string\">'enabled'\u003C/span>]:\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span>\n        \n        \u003Cspan class=\"hljs-comment\"># Extract frontmatter\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> content.startswith(\u003Cspan class=\"hljs-string\">'---'\u003C/span>):\n            self.results.append(ValidationResult(\n                rule_id=\u003Cspan class=\"hljs-string\">'frontmatter_missing'\u003C/span>,\n                severity=ValidationSeverity.ERROR,\n                message=\u003Cspan class=\"hljs-string\">'Missing YAML frontmatter'\u003C/span>,\n                file_path=file_path,\n                line_number=\u003Cspan class=\"hljs-number\">1\u003C/span>,\n                fix_suggestion=\u003Cspan class=\"hljs-string\">'Add YAML frontmatter starting with ---'\u003C/span>\n            ))\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span>\n        \n        \u003Cspan class=\"hljs-comment\"># Find frontmatter boundaries\u003C/span>\n        end_marker = \u003Cspan class=\"hljs-literal\">None\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> i, line \u003Cspan class=\"hljs-keyword\">in\u003C/span> \u003Cspan class=\"hljs-built_in\">enumerate\u003C/span>(lines[\u003Cspan class=\"hljs-number\">1\u003C/span>:], \u003Cspan class=\"hljs-number\">1\u003C/span>):\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> line.strip() == \u003Cspan class=\"hljs-string\">'---'\u003C/span>:\n                end_marker = i\n                \u003Cspan class=\"hljs-keyword\">break\u003C/span>\n        \n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> end_marker \u003Cspan class=\"hljs-keyword\">is\u003C/span> \u003Cspan class=\"hljs-literal\">None\u003C/span>:\n            self.results.append(ValidationResult(\n                rule_id=\u003Cspan class=\"hljs-string\">'frontmatter_malformed'\u003C/span>,\n                severity=ValidationSeverity.ERROR,\n                message=\u003Cspan class=\"hljs-string\">'Frontmatter not properly closed'\u003C/span>,\n                file_path=file_path,\n                line_number=\u003Cspan class=\"hljs-number\">1\u003C/span>,\n                fix_suggestion=\u003Cspan class=\"hljs-string\">'Add closing --- after frontmatter'\u003C/span>\n            ))\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span>\n        \n        \u003Cspan class=\"hljs-comment\"># Parse frontmatter YAML\u003C/span>\n        frontmatter_lines = lines[\u003Cspan class=\"hljs-number\">1\u003C/span>:end_marker]\n        frontmatter_text = \u003Cspan class=\"hljs-string\">'\\n'\u003C/span>.join(frontmatter_lines)\n        \n        \u003Cspan class=\"hljs-keyword\">try\u003C/span>:\n            frontmatter = yaml.safe_load(frontmatter_text)\n        \u003Cspan class=\"hljs-keyword\">except\u003C/span> yaml.YAMLError \u003Cspan class=\"hljs-keyword\">as\u003C/span> e:\n            self.results.append(ValidationResult(\n                rule_id=\u003Cspan class=\"hljs-string\">'frontmatter_yaml_error'\u003C/span>,\n                severity=ValidationSeverity.ERROR,\n                message=\u003Cspan class=\"hljs-string\">f'Invalid YAML in frontmatter: \u003Cspan class=\"hljs-subst\">{e}\u003C/span>'\u003C/span>,\n                file_path=file_path,\n                line_number=\u003Cspan class=\"hljs-number\">1\u003C/span>,\n                context=frontmatter_text[:\u003Cspan class=\"hljs-number\">100\u003C/span>]\n            ))\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span>\n        \n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> \u003Cspan class=\"hljs-built_in\">isinstance\u003C/span>(frontmatter, \u003Cspan class=\"hljs-built_in\">dict\u003C/span>):\n            self.results.append(ValidationResult(\n                rule_id=\u003Cspan class=\"hljs-string\">'frontmatter_not_dict'\u003C/span>,\n                severity=ValidationSeverity.ERROR,\n                message=\u003Cspan class=\"hljs-string\">'Frontmatter must be a YAML dictionary'\u003C/span>,\n                file_path=file_path,\n                line_number=\u003Cspan class=\"hljs-number\">1\u003C/span>\n            ))\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span>\n        \n        \u003Cspan class=\"hljs-comment\"># Check required fields\u003C/span>\n        required_fields = self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'frontmatter'\u003C/span>][\u003Cspan class=\"hljs-string\">'required_fields'\u003C/span>]\n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> field \u003Cspan class=\"hljs-keyword\">in\u003C/span> required_fields:\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> field \u003Cspan class=\"hljs-keyword\">not\u003C/span> \u003Cspan class=\"hljs-keyword\">in\u003C/span> frontmatter \u003Cspan class=\"hljs-keyword\">or\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> frontmatter[field]:\n                self.results.append(ValidationResult(\n                    rule_id=\u003Cspan class=\"hljs-string\">f'frontmatter_missing_\u003Cspan class=\"hljs-subst\">{field}\u003C/span>'\u003C/span>,\n                    severity=ValidationSeverity.ERROR,\n                    message=\u003Cspan class=\"hljs-string\">f'Missing required frontmatter field: \u003Cspan class=\"hljs-subst\">{field}\u003C/span>'\u003C/span>,\n                    file_path=file_path,\n                    line_number=self.find_field_line(frontmatter_lines, field),\n                    fix_suggestion=\u003Cspan class=\"hljs-string\">f'Add \u003Cspan class=\"hljs-subst\">{field}\u003C/span>: "value" to frontmatter'\u003C/span>\n                ))\n        \n        \u003Cspan class=\"hljs-comment\"># Validate field constraints\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-string\">'title'\u003C/span> \u003Cspan class=\"hljs-keyword\">in\u003C/span> frontmatter:\n            title_length = \u003Cspan class=\"hljs-built_in\">len\u003C/span>(\u003Cspan class=\"hljs-built_in\">str\u003C/span>(frontmatter[\u003Cspan class=\"hljs-string\">'title'\u003C/span>]))\n            max_length = self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'frontmatter'\u003C/span>][\u003Cspan class=\"hljs-string\">'title_max_length'\u003C/span>]\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> title_length > max_length:\n                self.results.append(ValidationResult(\n                    rule_id=\u003Cspan class=\"hljs-string\">'frontmatter_title_too_long'\u003C/span>,\n                    severity=ValidationSeverity.WARNING,\n                    message=\u003Cspan class=\"hljs-string\">f'Title too long (\u003Cspan class=\"hljs-subst\">{title_length}\u003C/span> chars, max \u003Cspan class=\"hljs-subst\">{max_length}\u003C/span>)'\u003C/span>,\n                    file_path=file_path,\n                    line_number=self.find_field_line(frontmatter_lines, \u003Cspan class=\"hljs-string\">'title'\u003C/span>)\n                ))\n        \n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-string\">'description'\u003C/span> \u003Cspan class=\"hljs-keyword\">in\u003C/span> frontmatter:\n            desc_length = \u003Cspan class=\"hljs-built_in\">len\u003C/span>(\u003Cspan class=\"hljs-built_in\">str\u003C/span>(frontmatter[\u003Cspan class=\"hljs-string\">'description'\u003C/span>]))\n            max_length = self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'frontmatter'\u003C/span>][\u003Cspan class=\"hljs-string\">'description_max_length'\u003C/span>]\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> desc_length > max_length:\n                self.results.append(ValidationResult(\n                    rule_id=\u003Cspan class=\"hljs-string\">'frontmatter_description_too_long'\u003C/span>,\n                    severity=ValidationSeverity.WARNING,\n                    message=\u003Cspan class=\"hljs-string\">f'Description too long (\u003Cspan class=\"hljs-subst\">{desc_length}\u003C/span> chars, max \u003Cspan class=\"hljs-subst\">{max_length}\u003C/span>)'\u003C/span>,\n                    file_path=file_path,\n                    line_number=self.find_field_line(frontmatter_lines, \u003Cspan class=\"hljs-string\">'description'\u003C/span>)\n                ))\n        \n        \u003Cspan class=\"hljs-comment\"># Validate date format\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-string\">'date'\u003C/span> \u003Cspan class=\"hljs-keyword\">in\u003C/span> frontmatter:\n            date_format = self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'frontmatter'\u003C/span>][\u003Cspan class=\"hljs-string\">'date_format'\u003C/span>]\n            \u003Cspan class=\"hljs-keyword\">try\u003C/span>:\n                datetime.strptime(\u003Cspan class=\"hljs-built_in\">str\u003C/span>(frontmatter[\u003Cspan class=\"hljs-string\">'date'\u003C/span>]), date_format)\n            \u003Cspan class=\"hljs-keyword\">except\u003C/span> ValueError:\n                self.results.append(ValidationResult(\n                    rule_id=\u003Cspan class=\"hljs-string\">'frontmatter_invalid_date'\u003C/span>,\n                    severity=ValidationSeverity.ERROR,\n                    message=\u003Cspan class=\"hljs-string\">f'Invalid date format, expected \u003Cspan class=\"hljs-subst\">{date_format}\u003C/span>'\u003C/span>,\n                    file_path=file_path,\n                    line_number=self.find_field_line(frontmatter_lines, \u003Cspan class=\"hljs-string\">'date'\u003C/span>),\n                    fix_suggestion=\u003Cspan class=\"hljs-string\">f'Use date format: \u003Cspan class=\"hljs-subst\">{date_format}\u003C/span>'\u003C/span>\n                ))\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">find_field_line\u003C/span>(\u003Cspan class=\"hljs-params\">self, frontmatter_lines: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>], field: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\u003C/span>) -> \u003Cspan class=\"hljs-type\">Optional\u003C/span>[\u003Cspan class=\"hljs-built_in\">int\u003C/span>]:\n        \u003Cspan class=\"hljs-string\">"""Find line number of a frontmatter field"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> i, line \u003Cspan class=\"hljs-keyword\">in\u003C/span> \u003Cspan class=\"hljs-built_in\">enumerate\u003C/span>(frontmatter_lines, \u003Cspan class=\"hljs-number\">2\u003C/span>):  \u003Cspan class=\"hljs-comment\"># +2 for 0-index and --- line\u003C/span>\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> line.strip().startswith(\u003Cspan class=\"hljs-string\">f'\u003Cspan class=\"hljs-subst\">{field}\u003C/span>:'\u003C/span>):\n                \u003Cspan class=\"hljs-keyword\">return\u003C/span> i\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-literal\">None\u003C/span>\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">validate_headings\u003C/span>(\u003Cspan class=\"hljs-params\">self, file_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, content: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, lines: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>]\u003C/span>):\n        \u003Cspan class=\"hljs-string\">"""Validate heading structure and formatting"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'headings'\u003C/span>][\u003Cspan class=\"hljs-string\">'enabled'\u003C/span>]:\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span>\n        \n        heading_pattern = re.\u003Cspan class=\"hljs-built_in\">compile\u003C/span>(\u003Cspan class=\"hljs-string\">r'^(#{1,6})\\s+(.+)$'\u003C/span>)\n        found_h1 = \u003Cspan class=\"hljs-literal\">False\u003C/span>\n        seen_headings = \u003Cspan class=\"hljs-built_in\">set\u003C/span>()\n        \n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> line_num, line \u003Cspan class=\"hljs-keyword\">in\u003C/span> \u003Cspan class=\"hljs-built_in\">enumerate\u003C/span>(lines, \u003Cspan class=\"hljs-number\">1\u003C/span>):\n            \u003Cspan class=\"hljs-keyword\">match\u003C/span> = heading_pattern.\u003Cspan class=\"hljs-keyword\">match\u003C/span>(line)\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> \u003Cspan class=\"hljs-keyword\">match\u003C/span>:\n                \u003Cspan class=\"hljs-keyword\">continue\u003C/span>\n            \n            level = \u003Cspan class=\"hljs-built_in\">len\u003C/span>(\u003Cspan class=\"hljs-keyword\">match\u003C/span>.group(\u003Cspan class=\"hljs-number\">1\u003C/span>))\n            heading_text = \u003Cspan class=\"hljs-keyword\">match\u003C/span>.group(\u003Cspan class=\"hljs-number\">2\u003C/span>).strip()\n            \n            \u003Cspan class=\"hljs-comment\"># Check for H1\u003C/span>\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> level == \u003Cspan class=\"hljs-number\">1\u003C/span>:\n                found_h1 = \u003Cspan class=\"hljs-literal\">True\u003C/span>\n            \n            \u003Cspan class=\"hljs-comment\"># Check for empty headings\u003C/span>\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'headings'\u003C/span>][\u003Cspan class=\"hljs-string\">'no_empty_headings'\u003C/span>] \u003Cspan class=\"hljs-keyword\">and\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> heading_text:\n                self.results.append(ValidationResult(\n                    rule_id=\u003Cspan class=\"hljs-string\">'heading_empty'\u003C/span>,\n                    severity=ValidationSeverity.ERROR,\n                    message=\u003Cspan class=\"hljs-string\">'Empty heading found'\u003C/span>,\n                    file_path=file_path,\n                    line_number=line_num,\n                    context=line,\n                    fix_suggestion=\u003Cspan class=\"hljs-string\">'Add content to the heading or remove it'\u003C/span>\n                ))\n                \u003Cspan class=\"hljs-keyword\">continue\u003C/span>\n            \n            \u003Cspan class=\"hljs-comment\"># Check heading length\u003C/span>\n            max_length = self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'headings'\u003C/span>][\u003Cspan class=\"hljs-string\">'max_heading_length'\u003C/span>]\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-built_in\">len\u003C/span>(heading_text) > max_length:\n                self.results.append(ValidationResult(\n                    rule_id=\u003Cspan class=\"hljs-string\">'heading_too_long'\u003C/span>,\n                    severity=ValidationSeverity.WARNING,\n                    message=\u003Cspan class=\"hljs-string\">f'Heading too long (\u003Cspan class=\"hljs-subst\">{\u003Cspan class=\"hljs-built_in\">len\u003C/span>(heading_text)}\u003C/span> chars, max \u003Cspan class=\"hljs-subst\">{max_length}\u003C/span>)'\u003C/span>,\n                    file_path=file_path,\n                    line_number=line_num,\n                    context=heading_text[:\u003Cspan class=\"hljs-number\">50\u003C/span>] + \u003Cspan class=\"hljs-string\">'...'\u003C/span> \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-built_in\">len\u003C/span>(heading_text) > \u003Cspan class=\"hljs-number\">50\u003C/span> \u003Cspan class=\"hljs-keyword\">else\u003C/span> heading_text\n                ))\n            \n            \u003Cspan class=\"hljs-comment\"># Check for duplicate headings\u003C/span>\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'headings'\u003C/span>][\u003Cspan class=\"hljs-string\">'no_duplicate_headings'\u003C/span>]:\n                heading_lower = heading_text.lower()\n                \u003Cspan class=\"hljs-keyword\">if\u003C/span> heading_lower \u003Cspan class=\"hljs-keyword\">in\u003C/span> seen_headings:\n                    self.results.append(ValidationResult(\n                        rule_id=\u003Cspan class=\"hljs-string\">'heading_duplicate'\u003C/span>,\n                        severity=ValidationSeverity.WARNING,\n                        message=\u003Cspan class=\"hljs-string\">f'Duplicate heading: \u003Cspan class=\"hljs-subst\">{heading_text}\u003C/span>'\u003C/span>,\n                        file_path=file_path,\n                        line_number=line_num,\n                        context=heading_text\n                    ))\n                seen_headings.add(heading_lower)\n            \n            \u003Cspan class=\"hljs-comment\"># Check heading case\u003C/span>\n            case_style = self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'headings'\u003C/span>][\u003Cspan class=\"hljs-string\">'heading_case'\u003C/span>]\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> case_style == \u003Cspan class=\"hljs-string\">'title'\u003C/span> \u003Cspan class=\"hljs-keyword\">and\u003C/span> heading_text != heading_text.title():\n                self.results.append(ValidationResult(\n                    rule_id=\u003Cspan class=\"hljs-string\">'heading_case_title'\u003C/span>,\n                    severity=ValidationSeverity.INFO,\n                    message=\u003Cspan class=\"hljs-string\">'Heading should use title case'\u003C/span>,\n                    file_path=file_path,\n                    line_number=line_num,\n                    context=heading_text,\n                    fix_suggestion=\u003Cspan class=\"hljs-string\">f'Change to: \u003Cspan class=\"hljs-subst\">{heading_text.title()}\u003C/span>'\u003C/span>\n                ))\n        \n        \u003Cspan class=\"hljs-comment\"># Check for required H1\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'headings'\u003C/span>][\u003Cspan class=\"hljs-string\">'require_h1'\u003C/span>] \u003Cspan class=\"hljs-keyword\">and\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> found_h1:\n            self.results.append(ValidationResult(\n                rule_id=\u003Cspan class=\"hljs-string\">'heading_missing_h1'\u003C/span>,\n                severity=ValidationSeverity.ERROR,\n                message=\u003Cspan class=\"hljs-string\">'Document missing H1 heading'\u003C/span>,\n                file_path=file_path,\n                line_number=\u003Cspan class=\"hljs-number\">1\u003C/span>,\n                fix_suggestion=\u003Cspan class=\"hljs-string\">'Add a main heading with # at the top of the document'\u003C/span>\n            ))\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">validate_links\u003C/span>(\u003Cspan class=\"hljs-params\">self, file_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, content: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, lines: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>]\u003C/span>):\n        \u003Cspan class=\"hljs-string\">"""Validate internal and external links"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'links'\u003C/span>][\u003Cspan class=\"hljs-string\">'enabled'\u003C/span>]:\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span>\n        \n        \u003Cspan class=\"hljs-comment\"># Find all markdown links\u003C/span>\n        link_pattern = re.\u003Cspan class=\"hljs-built_in\">compile\u003C/span>(\u003Cspan class=\"hljs-string\">r'\\[([^\\]]*)\\]\\(([^)]+)\\)'\u003C/span>)\n        \n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> line_num, line \u003Cspan class=\"hljs-keyword\">in\u003C/span> \u003Cspan class=\"hljs-built_in\">enumerate\u003C/span>(lines, \u003Cspan class=\"hljs-number\">1\u003C/span>):\n            \u003Cspan class=\"hljs-keyword\">for\u003C/span> \u003Cspan class=\"hljs-keyword\">match\u003C/span> \u003Cspan class=\"hljs-keyword\">in\u003C/span> link_pattern.finditer(line):\n                link_text = \u003Cspan class=\"hljs-keyword\">match\u003C/span>.group(\u003Cspan class=\"hljs-number\">1\u003C/span>)\n                link_url = \u003Cspan class=\"hljs-keyword\">match\u003C/span>.group(\u003Cspan class=\"hljs-number\">2\u003C/span>)\n                \n                \u003Cspan class=\"hljs-comment\"># Skip empty links\u003C/span>\n                \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> link_url:\n                    self.results.append(ValidationResult(\n                        rule_id=\u003Cspan class=\"hljs-string\">'link_empty_url'\u003C/span>,\n                        severity=ValidationSeverity.ERROR,\n                        message=\u003Cspan class=\"hljs-string\">'Link with empty URL'\u003C/span>,\n                        file_path=file_path,\n                        line_number=line_num,\n                        context=\u003Cspan class=\"hljs-keyword\">match\u003C/span>.group(\u003Cspan class=\"hljs-number\">0\u003C/span>)\n                    ))\n                    \u003Cspan class=\"hljs-keyword\">continue\u003C/span>\n                \n                \u003Cspan class=\"hljs-comment\"># Check link text\u003C/span>\n                \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> link_text:\n                    self.results.append(ValidationResult(\n                        rule_id=\u003Cspan class=\"hljs-string\">'link_empty_text'\u003C/span>,\n                        severity=ValidationSeverity.WARNING,\n                        message=\u003Cspan class=\"hljs-string\">'Link with empty text'\u003C/span>,\n                        file_path=file_path,\n                        line_number=line_num,\n                        context=\u003Cspan class=\"hljs-keyword\">match\u003C/span>.group(\u003Cspan class=\"hljs-number\">0\u003C/span>),\n                        fix_suggestion=\u003Cspan class=\"hljs-string\">'Add descriptive link text'\u003C/span>\n                    ))\n                \n                \u003Cspan class=\"hljs-comment\"># Validate internal links\u003C/span>\n                \u003Cspan class=\"hljs-keyword\">if\u003C/span> self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'links'\u003C/span>][\u003Cspan class=\"hljs-string\">'check_internal'\u003C/span>] \u003Cspan class=\"hljs-keyword\">and\u003C/span> self.is_internal_link(link_url):\n                    \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> self.validate_internal_link(file_path, link_url):\n                        self.results.append(ValidationResult(\n                            rule_id=\u003Cspan class=\"hljs-string\">'link_broken_internal'\u003C/span>,\n                            severity=ValidationSeverity.ERROR,\n                            message=\u003Cspan class=\"hljs-string\">f'Broken internal link: \u003Cspan class=\"hljs-subst\">{link_url}\u003C/span>'\u003C/span>,\n                            file_path=file_path,\n                            line_number=line_num,\n                            context=\u003Cspan class=\"hljs-keyword\">match\u003C/span>.group(\u003Cspan class=\"hljs-number\">0\u003C/span>)\n                        ))\n                \n                \u003Cspan class=\"hljs-comment\"># Validate external links\u003C/span>\n                \u003Cspan class=\"hljs-keyword\">if\u003C/span> self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'links'\u003C/span>][\u003Cspan class=\"hljs-string\">'check_external'\u003C/span>] \u003Cspan class=\"hljs-keyword\">and\u003C/span> self.is_external_link(link_url):\n                    \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> self.validate_external_link(link_url):\n                        self.results.append(ValidationResult(\n                            rule_id=\u003Cspan class=\"hljs-string\">'link_broken_external'\u003C/span>,\n                            severity=ValidationSeverity.WARNING,\n                            message=\u003Cspan class=\"hljs-string\">f'Broken external link: \u003Cspan class=\"hljs-subst\">{link_url}\u003C/span>'\u003C/span>,\n                            file_path=file_path,\n                            line_number=line_num,\n                            context=\u003Cspan class=\"hljs-keyword\">match\u003C/span>.group(\u003Cspan class=\"hljs-number\">0\u003C/span>)\n                        ))\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">is_internal_link\u003C/span>(\u003Cspan class=\"hljs-params\">self, url: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\u003C/span>) -> \u003Cspan class=\"hljs-built_in\">bool\u003C/span>:\n        \u003Cspan class=\"hljs-string\">"""Check if URL is an internal link"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> url.startswith((\u003Cspan class=\"hljs-string\">'http://'\u003C/span>, \u003Cspan class=\"hljs-string\">'https://'\u003C/span>, \u003Cspan class=\"hljs-string\">'mailto:'\u003C/span>, \u003Cspan class=\"hljs-string\">'tel:'\u003C/span>, \u003Cspan class=\"hljs-string\">'ftp://'\u003C/span>))\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">is_external_link\u003C/span>(\u003Cspan class=\"hljs-params\">self, url: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\u003C/span>) -> \u003Cspan class=\"hljs-built_in\">bool\u003C/span>:\n        \u003Cspan class=\"hljs-string\">"""Check if URL is an external link"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> url.startswith((\u003Cspan class=\"hljs-string\">'http://'\u003C/span>, \u003Cspan class=\"hljs-string\">'https://'\u003C/span>))\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">validate_internal_link\u003C/span>(\u003Cspan class=\"hljs-params\">self, base_file: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, link_url: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\u003C/span>) -> \u003Cspan class=\"hljs-built_in\">bool\u003C/span>:\n        \u003Cspan class=\"hljs-string\">"""Validate internal link exists"""\u003C/span>\n        base_dir = os.path.dirname(base_file)\n        \n        \u003Cspan class=\"hljs-comment\"># Handle fragments\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-string\">'#'\u003C/span> \u003Cspan class=\"hljs-keyword\">in\u003C/span> link_url:\n            file_part, fragment = link_url.split(\u003Cspan class=\"hljs-string\">'#'\u003C/span>, \u003Cspan class=\"hljs-number\">1\u003C/span>)\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> file_part:  \u003Cspan class=\"hljs-comment\"># Same-page fragment\u003C/span>\n                \u003Cspan class=\"hljs-keyword\">return\u003C/span> self.validate_fragment(base_file, fragment)\n            link_url = file_part\n        \n        \u003Cspan class=\"hljs-comment\"># Resolve relative path\u003C/span>\n        target_path = os.path.normpath(os.path.join(base_dir, link_url))\n        \n        \u003Cspan class=\"hljs-comment\"># Check if file exists\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> os.path.exists(target_path):\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-literal\">True\u003C/span>\n        \n        \u003Cspan class=\"hljs-comment\"># Try with .md extension if not present\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> target_path.endswith(\u003Cspan class=\"hljs-string\">'.md'\u003C/span>):\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> os.path.exists(target_path + \u003Cspan class=\"hljs-string\">'.md'\u003C/span>):\n                \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-literal\">True\u003C/span>\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-literal\">False\u003C/span>\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">validate_external_link\u003C/span>(\u003Cspan class=\"hljs-params\">self, url: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\u003C/span>) -> \u003Cspan class=\"hljs-built_in\">bool\u003C/span>:\n        \u003Cspan class=\"hljs-string\">"""Validate external link is accessible"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">try\u003C/span>:\n            timeout = self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'links'\u003C/span>][\u003Cspan class=\"hljs-string\">'timeout'\u003C/span>]\n            retry_count = self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'links'\u003C/span>][\u003Cspan class=\"hljs-string\">'retry_count'\u003C/span>]\n            \n            \u003Cspan class=\"hljs-keyword\">for\u003C/span> attempt \u003Cspan class=\"hljs-keyword\">in\u003C/span> \u003Cspan class=\"hljs-built_in\">range\u003C/span>(retry_count + \u003Cspan class=\"hljs-number\">1\u003C/span>):\n                \u003Cspan class=\"hljs-keyword\">try\u003C/span>:\n                    response = requests.head(url, timeout=timeout, allow_redirects=\u003Cspan class=\"hljs-literal\">True\u003C/span>)\n                    \u003Cspan class=\"hljs-keyword\">return\u003C/span> response.status_code < \u003Cspan class=\"hljs-number\">400\u003C/span>\n                \u003Cspan class=\"hljs-keyword\">except\u003C/span> requests.RequestException:\n                    \u003Cspan class=\"hljs-keyword\">if\u003C/span> attempt == retry_count:\n                        \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-literal\">False\u003C/span>\n                    \u003Cspan class=\"hljs-keyword\">continue\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">except\u003C/span> Exception:\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-literal\">False\u003C/span>\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">validate_fragment\u003C/span>(\u003Cspan class=\"hljs-params\">self, file_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, fragment: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\u003C/span>) -> \u003Cspan class=\"hljs-built_in\">bool\u003C/span>:\n        \u003Cspan class=\"hljs-string\">"""Check if fragment/anchor exists in file"""\u003C/span>\n        content = self.file_cache[file_path][\u003Cspan class=\"hljs-string\">'content'\u003C/span>]\n        \n        \u003Cspan class=\"hljs-comment\"># Look for heading that matches fragment\u003C/span>\n        heading_pattern = re.\u003Cspan class=\"hljs-built_in\">compile\u003C/span>(\u003Cspan class=\"hljs-string\">r'^#+\\s+(.+)$'\u003C/span>, re.MULTILINE)\n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> \u003Cspan class=\"hljs-keyword\">match\u003C/span> \u003Cspan class=\"hljs-keyword\">in\u003C/span> heading_pattern.finditer(content):\n            heading_text = \u003Cspan class=\"hljs-keyword\">match\u003C/span>.group(\u003Cspan class=\"hljs-number\">1\u003C/span>)\n            \u003Cspan class=\"hljs-comment\"># Convert heading to URL fragment format\u003C/span>\n            heading_fragment = re.sub(\u003Cspan class=\"hljs-string\">r'[^a-zA-Z0-9\\-_]'\u003C/span>, \u003Cspan class=\"hljs-string\">'-'\u003C/span>, heading_text.lower())\n            heading_fragment = re.sub(\u003Cspan class=\"hljs-string\">r'-+'\u003C/span>, \u003Cspan class=\"hljs-string\">'-'\u003C/span>, heading_fragment).strip(\u003Cspan class=\"hljs-string\">'-'\u003C/span>)\n            \n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> heading_fragment == fragment:\n                \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-literal\">True\u003C/span>\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-literal\">False\u003C/span>\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">validate_images\u003C/span>(\u003Cspan class=\"hljs-params\">self, file_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, content: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, lines: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>]\u003C/span>):\n        \u003Cspan class=\"hljs-string\">"""Validate image references and properties"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'images'\u003C/span>][\u003Cspan class=\"hljs-string\">'enabled'\u003C/span>]:\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span>\n        \n        image_pattern = re.\u003Cspan class=\"hljs-built_in\">compile\u003C/span>(\u003Cspan class=\"hljs-string\">r'!\\[([^\\]]*)\\]\\(([^)]+)\\)'\u003C/span>)\n        \n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> line_num, line \u003Cspan class=\"hljs-keyword\">in\u003C/span> \u003Cspan class=\"hljs-built_in\">enumerate\u003C/span>(lines, \u003Cspan class=\"hljs-number\">1\u003C/span>):\n            \u003Cspan class=\"hljs-keyword\">for\u003C/span> \u003Cspan class=\"hljs-keyword\">match\u003C/span> \u003Cspan class=\"hljs-keyword\">in\u003C/span> image_pattern.finditer(line):\n                alt_text = \u003Cspan class=\"hljs-keyword\">match\u003C/span>.group(\u003Cspan class=\"hljs-number\">1\u003C/span>)\n                image_url = \u003Cspan class=\"hljs-keyword\">match\u003C/span>.group(\u003Cspan class=\"hljs-number\">2\u003C/span>)\n                \n                \u003Cspan class=\"hljs-comment\"># Check alt text\u003C/span>\n                \u003Cspan class=\"hljs-keyword\">if\u003C/span> self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'images'\u003C/span>][\u003Cspan class=\"hljs-string\">'require_alt_text'\u003C/span>] \u003Cspan class=\"hljs-keyword\">and\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> alt_text:\n                    self.results.append(ValidationResult(\n                        rule_id=\u003Cspan class=\"hljs-string\">'image_missing_alt'\u003C/span>,\n                        severity=ValidationSeverity.WARNING,\n                        message=\u003Cspan class=\"hljs-string\">'Image missing alt text'\u003C/span>,\n                        file_path=file_path,\n                        line_number=line_num,\n                        context=\u003Cspan class=\"hljs-keyword\">match\u003C/span>.group(\u003Cspan class=\"hljs-number\">0\u003C/span>),\n                        fix_suggestion=\u003Cspan class=\"hljs-string\">'Add descriptive alt text for accessibility'\u003C/span>\n                    ))\n                \n                \u003Cspan class=\"hljs-comment\"># Validate image file\u003C/span>\n                \u003Cspan class=\"hljs-keyword\">if\u003C/span> self.is_internal_link(image_url):\n                    self.validate_image_file(file_path, image_url, line_num, \u003Cspan class=\"hljs-keyword\">match\u003C/span>.group(\u003Cspan class=\"hljs-number\">0\u003C/span>))\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">validate_image_file\u003C/span>(\u003Cspan class=\"hljs-params\">self, base_file: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, image_url: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, line_num: \u003Cspan class=\"hljs-built_in\">int\u003C/span>, context: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\u003C/span>):\n        \u003Cspan class=\"hljs-string\">"""Validate image file properties"""\u003C/span>\n        base_dir = os.path.dirname(base_file)\n        image_path = os.path.normpath(os.path.join(base_dir, image_url))\n        \n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> os.path.exists(image_path):\n            self.results.append(ValidationResult(\n                rule_id=\u003Cspan class=\"hljs-string\">'image_file_missing'\u003C/span>,\n                severity=ValidationSeverity.ERROR,\n                message=\u003Cspan class=\"hljs-string\">f'Image file not found: \u003Cspan class=\"hljs-subst\">{image_url}\u003C/span>'\u003C/span>,\n                file_path=base_file,\n                line_number=line_num,\n                context=context\n            ))\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span>\n        \n        \u003Cspan class=\"hljs-comment\"># Check file extension\u003C/span>\n        allowed_formats = self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'images'\u003C/span>][\u003Cspan class=\"hljs-string\">'allowed_formats'\u003C/span>]\n        file_ext = os.path.splitext(image_path)[\u003Cspan class=\"hljs-number\">1\u003C/span>].lower().lstrip(\u003Cspan class=\"hljs-string\">'.'\u003C/span>)\n        \n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> file_ext \u003Cspan class=\"hljs-keyword\">not\u003C/span> \u003Cspan class=\"hljs-keyword\">in\u003C/span> allowed_formats:\n            self.results.append(ValidationResult(\n                rule_id=\u003Cspan class=\"hljs-string\">'image_invalid_format'\u003C/span>,\n                severity=ValidationSeverity.WARNING,\n                message=\u003Cspan class=\"hljs-string\">f'Image format not allowed: \u003Cspan class=\"hljs-subst\">{file_ext}\u003C/span> (allowed: \u003Cspan class=\"hljs-subst\">{\u003Cspan class=\"hljs-string\">", "\u003C/span>.join(allowed_formats)}\u003C/span>)'\u003C/span>,\n                file_path=base_file,\n                line_number=line_num,\n                context=context\n            ))\n        \n        \u003Cspan class=\"hljs-comment\"># Check file size\u003C/span>\n        file_size_mb = os.path.getsize(image_path) / (\u003Cspan class=\"hljs-number\">1024\u003C/span> * \u003Cspan class=\"hljs-number\">1024\u003C/span>)\n        max_size = self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'images'\u003C/span>][\u003Cspan class=\"hljs-string\">'max_size_mb'\u003C/span>]\n        \n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> file_size_mb > max_size:\n            self.results.append(ValidationResult(\n                rule_id=\u003Cspan class=\"hljs-string\">'image_too_large'\u003C/span>,\n                severity=ValidationSeverity.WARNING,\n                message=\u003Cspan class=\"hljs-string\">f'Image too large: \u003Cspan class=\"hljs-subst\">{file_size_mb:\u003Cspan class=\"hljs-number\">.1\u003C/span>f}\u003C/span>MB (max \u003Cspan class=\"hljs-subst\">{max_size}\u003C/span>MB)'\u003C/span>,\n                file_path=base_file,\n                line_number=line_num,\n                context=context,\n                fix_suggestion=\u003Cspan class=\"hljs-string\">'Optimize image size or use web-optimized format'\u003C/span>\n            ))\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">validate_content_structure\u003C/span>(\u003Cspan class=\"hljs-params\">self, file_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, content: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, lines: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>]\u003C/span>):\n        \u003Cspan class=\"hljs-string\">"""Validate overall content structure and formatting"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'content'\u003C/span>][\u003Cspan class=\"hljs-string\">'enabled'\u003C/span>]:\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span>\n        \n        \u003Cspan class=\"hljs-comment\"># Word count check\u003C/span>\n        word_count = \u003Cspan class=\"hljs-built_in\">len\u003C/span>(content.split())\n        min_words = self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'content'\u003C/span>][\u003Cspan class=\"hljs-string\">'min_word_count'\u003C/span>]\n        \n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> word_count < min_words:\n            self.results.append(ValidationResult(\n                rule_id=\u003Cspan class=\"hljs-string\">'content_too_short'\u003C/span>,\n                severity=ValidationSeverity.INFO,\n                message=\u003Cspan class=\"hljs-string\">f'Content may be too short: \u003Cspan class=\"hljs-subst\">{word_count}\u003C/span> words (min \u003Cspan class=\"hljs-subst\">{min_words}\u003C/span>)'\u003C/span>,\n                file_path=file_path,\n                line_number=\u003Cspan class=\"hljs-number\">1\u003C/span>\n            ))\n        \n        \u003Cspan class=\"hljs-comment\"># Line length check\u003C/span>\n        max_line_length = self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'content'\u003C/span>][\u003Cspan class=\"hljs-string\">'max_line_length'\u003C/span>]\n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> line_num, line \u003Cspan class=\"hljs-keyword\">in\u003C/span> \u003Cspan class=\"hljs-built_in\">enumerate\u003C/span>(lines, \u003Cspan class=\"hljs-number\">1\u003C/span>):\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-built_in\">len\u003C/span>(line) > max_line_length:\n                self.results.append(ValidationResult(\n                    rule_id=\u003Cspan class=\"hljs-string\">'line_too_long'\u003C/span>,\n                    severity=ValidationSeverity.INFO,\n                    message=\u003Cspan class=\"hljs-string\">f'Line too long: \u003Cspan class=\"hljs-subst\">{\u003Cspan class=\"hljs-built_in\">len\u003C/span>(line)}\u003C/span> chars (max \u003Cspan class=\"hljs-subst\">{max_line_length}\u003C/span>)'\u003C/span>,\n                    file_path=file_path,\n                    line_number=line_num,\n                    context=line[:\u003Cspan class=\"hljs-number\">50\u003C/span>] + \u003Cspan class=\"hljs-string\">'...'\u003C/span> \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-built_in\">len\u003C/span>(line) > \u003Cspan class=\"hljs-number\">50\u003C/span> \u003Cspan class=\"hljs-keyword\">else\u003C/span> line\n                ))\n        \n        \u003Cspan class=\"hljs-comment\"># Trailing whitespace check\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'content'\u003C/span>][\u003Cspan class=\"hljs-string\">'no_trailing_whitespace'\u003C/span>]:\n            \u003Cspan class=\"hljs-keyword\">for\u003C/span> line_num, line \u003Cspan class=\"hljs-keyword\">in\u003C/span> \u003Cspan class=\"hljs-built_in\">enumerate\u003C/span>(lines, \u003Cspan class=\"hljs-number\">1\u003C/span>):\n                \u003Cspan class=\"hljs-keyword\">if\u003C/span> line.endswith(\u003Cspan class=\"hljs-string\">' '\u003C/span>) \u003Cspan class=\"hljs-keyword\">or\u003C/span> line.endswith(\u003Cspan class=\"hljs-string\">'\\t'\u003C/span>):\n                    self.results.append(ValidationResult(\n                        rule_id=\u003Cspan class=\"hljs-string\">'trailing_whitespace'\u003C/span>,\n                        severity=ValidationSeverity.INFO,\n                        message=\u003Cspan class=\"hljs-string\">'Line has trailing whitespace'\u003C/span>,\n                        file_path=file_path,\n                        line_number=line_num,\n                        fix_suggestion=\u003Cspan class=\"hljs-string\">'Remove trailing whitespace'\u003C/span>\n                    ))\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">validate_code_blocks\u003C/span>(\u003Cspan class=\"hljs-params\">self, file_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, content: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, lines: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>]\u003C/span>):\n        \u003Cspan class=\"hljs-string\">"""Validate code blocks and syntax"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'code_blocks'\u003C/span>][\u003Cspan class=\"hljs-string\">'enabled'\u003C/span>]:\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span>\n        \n        code_block_pattern = re.\u003Cspan class=\"hljs-built_in\">compile\u003C/span>(\u003Cspan class=\"hljs-string\">r'^```(\\w*)$'\u003C/span>)\n        in_code_block = \u003Cspan class=\"hljs-literal\">False\u003C/span>\n        code_language = \u003Cspan class=\"hljs-literal\">None\u003C/span>\n        code_start_line = \u003Cspan class=\"hljs-literal\">None\u003C/span>\n        \n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> line_num, line \u003Cspan class=\"hljs-keyword\">in\u003C/span> \u003Cspan class=\"hljs-built_in\">enumerate\u003C/span>(lines, \u003Cspan class=\"hljs-number\">1\u003C/span>):\n            \u003Cspan class=\"hljs-keyword\">match\u003C/span> = code_block_pattern.\u003Cspan class=\"hljs-keyword\">match\u003C/span>(line)\n            \n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">match\u003C/span> \u003Cspan class=\"hljs-keyword\">and\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> in_code_block:\n                \u003Cspan class=\"hljs-comment\"># Start of code block\u003C/span>\n                in_code_block = \u003Cspan class=\"hljs-literal\">True\u003C/span>\n                code_language = \u003Cspan class=\"hljs-keyword\">match\u003C/span>.group(\u003Cspan class=\"hljs-number\">1\u003C/span>)\n                code_start_line = line_num\n                \n                \u003Cspan class=\"hljs-comment\"># Check for language tag\u003C/span>\n                \u003Cspan class=\"hljs-keyword\">if\u003C/span> self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'code_blocks'\u003C/span>][\u003Cspan class=\"hljs-string\">'require_language_tags'\u003C/span>] \u003Cspan class=\"hljs-keyword\">and\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> code_language:\n                    self.results.append(ValidationResult(\n                        rule_id=\u003Cspan class=\"hljs-string\">'code_block_missing_language'\u003C/span>,\n                        severity=ValidationSeverity.WARNING,\n                        message=\u003Cspan class=\"hljs-string\">'Code block missing language tag'\u003C/span>,\n                        file_path=file_path,\n                        line_number=line_num,\n                        context=line,\n                        fix_suggestion=\u003Cspan class=\"hljs-string\">'Add language identifier after ```'\u003C/span>\n                    ))\n                    \n            \u003Cspan class=\"hljs-keyword\">elif\u003C/span> \u003Cspan class=\"hljs-keyword\">match\u003C/span> \u003Cspan class=\"hljs-keyword\">and\u003C/span> in_code_block:\n                \u003Cspan class=\"hljs-comment\"># End of code block\u003C/span>\n                in_code_block = \u003Cspan class=\"hljs-literal\">False\u003C/span>\n                code_language = \u003Cspan class=\"hljs-literal\">None\u003C/span>\n                code_start_line = \u003Cspan class=\"hljs-literal\">None\u003C/span>\n                \n            \u003Cspan class=\"hljs-keyword\">elif\u003C/span> in_code_block:\n                \u003Cspan class=\"hljs-comment\"># Inside code block - check for secrets\u003C/span>\n                \u003Cspan class=\"hljs-keyword\">if\u003C/span> self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'code_blocks'\u003C/span>][\u003Cspan class=\"hljs-string\">'no_hardcoded_secrets'\u003C/span>]:\n                    self.check_for_secrets(file_path, line, line_num)\n        \n        \u003Cspan class=\"hljs-comment\"># Check for unclosed code blocks\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> in_code_block:\n            self.results.append(ValidationResult(\n                rule_id=\u003Cspan class=\"hljs-string\">'code_block_unclosed'\u003C/span>,\n                severity=ValidationSeverity.ERROR,\n                message=\u003Cspan class=\"hljs-string\">'Unclosed code block'\u003C/span>,\n                file_path=file_path,\n                line_number=code_start_line,\n                fix_suggestion=\u003Cspan class=\"hljs-string\">'Add closing ``` to close the code block'\u003C/span>\n            ))\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">check_for_secrets\u003C/span>(\u003Cspan class=\"hljs-params\">self, file_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, line: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, line_num: \u003Cspan class=\"hljs-built_in\">int\u003C/span>\u003C/span>):\n        \u003Cspan class=\"hljs-string\">"""Check for hardcoded secrets in code"""\u003C/span>\n        secret_patterns = [\n            \u003Cspan class=\"hljs-string\">r'(?i)(password|pwd|pass)\\s*[=:]\\s*["\\']?[a-zA-Z0-9!@#$%^&*()_+\\-=\\[\\]{};\\':"\\\\|,.<>/?]{8,}'\u003C/span>,\n            \u003Cspan class=\"hljs-string\">r'(?i)(api[_-]?key|apikey)\\s*[=:]\\s*["\\']?[a-zA-Z0-9]{20,}'\u003C/span>,\n            \u003Cspan class=\"hljs-string\">r'(?i)(secret|token)\\s*[=:]\\s*["\\']?[a-zA-Z0-9]{16,}'\u003C/span>,\n            \u003Cspan class=\"hljs-string\">r'(?i)(private[_-]?key)\\s*[=:]\\s*["\\']?-----BEGIN'\u003C/span>,\n        ]\n        \n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> pattern \u003Cspan class=\"hljs-keyword\">in\u003C/span> secret_patterns:\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> re.search(pattern, line):\n                self.results.append(ValidationResult(\n                    rule_id=\u003Cspan class=\"hljs-string\">'code_hardcoded_secret'\u003C/span>,\n                    severity=ValidationSeverity.WARNING,\n                    message=\u003Cspan class=\"hljs-string\">'Possible hardcoded secret detected'\u003C/span>,\n                    file_path=file_path,\n                    line_number=line_num,\n                    context=line[:\u003Cspan class=\"hljs-number\">50\u003C/span>] + \u003Cspan class=\"hljs-string\">'...'\u003C/span> \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-built_in\">len\u003C/span>(line) > \u003Cspan class=\"hljs-number\">50\u003C/span> \u003Cspan class=\"hljs-keyword\">else\u003C/span> line,\n                    fix_suggestion=\u003Cspan class=\"hljs-string\">'Use environment variables or placeholders for secrets'\u003C/span>\n                ))\n                \u003Cspan class=\"hljs-keyword\">break\u003C/span>\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">validate_accessibility\u003C/span>(\u003Cspan class=\"hljs-params\">self, file_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, content: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, lines: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>]\u003C/span>):\n        \u003Cspan class=\"hljs-string\">"""Validate accessibility compliance"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'accessibility'\u003C/span>][\u003Cspan class=\"hljs-string\">'enabled'\u003C/span>]:\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span>\n        \n        \u003Cspan class=\"hljs-comment\"># Check heading hierarchy\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'accessibility'\u003C/span>][\u003Cspan class=\"hljs-string\">'heading_hierarchy'\u003C/span>]:\n            self.validate_heading_hierarchy(file_path, lines)\n        \n        \u003Cspan class=\"hljs-comment\"># Check descriptive link text\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'accessibility'\u003C/span>][\u003Cspan class=\"hljs-string\">'link_text_descriptive'\u003C/span>]:\n            self.validate_descriptive_links(file_path, lines)\n        \n        \u003Cspan class=\"hljs-comment\"># Check table headers\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> self.config[\u003Cspan class=\"hljs-string\">'rules'\u003C/span>][\u003Cspan class=\"hljs-string\">'accessibility'\u003C/span>][\u003Cspan class=\"hljs-string\">'table_headers'\u003C/span>]:\n            self.validate_table_headers(file_path, lines)\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">validate_heading_hierarchy\u003C/span>(\u003Cspan class=\"hljs-params\">self, file_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, lines: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>]\u003C/span>):\n        \u003Cspan class=\"hljs-string\">"""Check proper heading hierarchy (no skipping levels)"""\u003C/span>\n        heading_pattern = re.\u003Cspan class=\"hljs-built_in\">compile\u003C/span>(\u003Cspan class=\"hljs-string\">r'^(#{1,6})\\s+(.+)$'\u003C/span>)\n        previous_level = \u003Cspan class=\"hljs-number\">0\u003C/span>\n        \n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> line_num, line \u003Cspan class=\"hljs-keyword\">in\u003C/span> \u003Cspan class=\"hljs-built_in\">enumerate\u003C/span>(lines, \u003Cspan class=\"hljs-number\">1\u003C/span>):\n            \u003Cspan class=\"hljs-keyword\">match\u003C/span> = heading_pattern.\u003Cspan class=\"hljs-keyword\">match\u003C/span>(line)\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> \u003Cspan class=\"hljs-keyword\">match\u003C/span>:\n                \u003Cspan class=\"hljs-keyword\">continue\u003C/span>\n            \n            current_level = \u003Cspan class=\"hljs-built_in\">len\u003C/span>(\u003Cspan class=\"hljs-keyword\">match\u003C/span>.group(\u003Cspan class=\"hljs-number\">1\u003C/span>))\n            \n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> previous_level > \u003Cspan class=\"hljs-number\">0\u003C/span> \u003Cspan class=\"hljs-keyword\">and\u003C/span> current_level > previous_level + \u003Cspan class=\"hljs-number\">1\u003C/span>:\n                self.results.append(ValidationResult(\n                    rule_id=\u003Cspan class=\"hljs-string\">'accessibility_heading_hierarchy'\u003C/span>,\n                    severity=ValidationSeverity.WARNING,\n                    message=\u003Cspan class=\"hljs-string\">f'Heading level skipped (h\u003Cspan class=\"hljs-subst\">{previous_level}\u003C/span> -> h\u003Cspan class=\"hljs-subst\">{current_level}\u003C/span>)'\u003C/span>,\n                    file_path=file_path,\n                    line_number=line_num,\n                    context=line,\n                    fix_suggestion=\u003Cspan class=\"hljs-string\">f'Use h\u003Cspan class=\"hljs-subst\">{previous_level + \u003Cspan class=\"hljs-number\">1\u003C/span>}\u003C/span> instead of h\u003Cspan class=\"hljs-subst\">{current_level}\u003C/span>'\u003C/span>\n                ))\n            \n            previous_level = current_level\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">validate_descriptive_links\u003C/span>(\u003Cspan class=\"hljs-params\">self, file_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, lines: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>]\u003C/span>):\n        \u003Cspan class=\"hljs-string\">"""Check for non-descriptive link text"""\u003C/span>\n        link_pattern = re.\u003Cspan class=\"hljs-built_in\">compile\u003C/span>(\u003Cspan class=\"hljs-string\">r'\\[([^\\]]*)\\]\\(([^)]+)\\)'\u003C/span>)\n        non_descriptive = [\u003Cspan class=\"hljs-string\">'click here'\u003C/span>, \u003Cspan class=\"hljs-string\">'read more'\u003C/span>, \u003Cspan class=\"hljs-string\">'here'\u003C/span>, \u003Cspan class=\"hljs-string\">'link'\u003C/span>, \u003Cspan class=\"hljs-string\">'more'\u003C/span>, \u003Cspan class=\"hljs-string\">'this'\u003C/span>]\n        \n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> line_num, line \u003Cspan class=\"hljs-keyword\">in\u003C/span> \u003Cspan class=\"hljs-built_in\">enumerate\u003C/span>(lines, \u003Cspan class=\"hljs-number\">1\u003C/span>):\n            \u003Cspan class=\"hljs-keyword\">for\u003C/span> \u003Cspan class=\"hljs-keyword\">match\u003C/span> \u003Cspan class=\"hljs-keyword\">in\u003C/span> link_pattern.finditer(line):\n                link_text = \u003Cspan class=\"hljs-keyword\">match\u003C/span>.group(\u003Cspan class=\"hljs-number\">1\u003C/span>).lower().strip()\n                \n                \u003Cspan class=\"hljs-keyword\">if\u003C/span> link_text \u003Cspan class=\"hljs-keyword\">in\u003C/span> non_descriptive:\n                    self.results.append(ValidationResult(\n                        rule_id=\u003Cspan class=\"hljs-string\">'accessibility_link_text'\u003C/span>,\n                        severity=ValidationSeverity.INFO,\n                        message=\u003Cspan class=\"hljs-string\">f'Non-descriptive link text: "\u003Cspan class=\"hljs-subst\">{link_text}\u003C/span>"'\u003C/span>,\n                        file_path=file_path,\n                        line_number=line_num,\n                        context=\u003Cspan class=\"hljs-keyword\">match\u003C/span>.group(\u003Cspan class=\"hljs-number\">0\u003C/span>),\n                        fix_suggestion=\u003Cspan class=\"hljs-string\">'Use descriptive text that explains the link destination'\u003C/span>\n                    ))\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">validate_table_headers\u003C/span>(\u003Cspan class=\"hljs-params\">self, file_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, lines: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>]\u003C/span>):\n        \u003Cspan class=\"hljs-string\">"""Check that tables have proper headers"""\u003C/span>\n        in_table = \u003Cspan class=\"hljs-literal\">False\u003C/span>\n        table_start = \u003Cspan class=\"hljs-literal\">None\u003C/span>\n        \n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> line_num, line \u003Cspan class=\"hljs-keyword\">in\u003C/span> \u003Cspan class=\"hljs-built_in\">enumerate\u003C/span>(lines, \u003Cspan class=\"hljs-number\">1\u003C/span>):\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-string\">'|'\u003C/span> \u003Cspan class=\"hljs-keyword\">in\u003C/span> line \u003Cspan class=\"hljs-keyword\">and\u003C/span> line.strip().startswith(\u003Cspan class=\"hljs-string\">'|'\u003C/span>) \u003Cspan class=\"hljs-keyword\">and\u003C/span> line.strip().endswith(\u003Cspan class=\"hljs-string\">'|'\u003C/span>):\n                \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> in_table:\n                    in_table = \u003Cspan class=\"hljs-literal\">True\u003C/span>\n                    table_start = line_num\n                    \n                    \u003Cspan class=\"hljs-comment\"># Check if next line is separator\u003C/span>\n                    \u003Cspan class=\"hljs-keyword\">if\u003C/span> line_num < \u003Cspan class=\"hljs-built_in\">len\u003C/span>(lines):\n                        next_line = lines[line_num]  \u003Cspan class=\"hljs-comment\"># line_num is 1-indexed\u003C/span>\n                        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> re.\u003Cspan class=\"hljs-keyword\">match\u003C/span>(\u003Cspan class=\"hljs-string\">r'^\\|[\\s\\-\\|:]+\\|$'\u003C/span>, next_line.strip()):\n                            self.results.append(ValidationResult(\n                                rule_id=\u003Cspan class=\"hljs-string\">'accessibility_table_headers'\u003C/span>,\n                                severity=ValidationSeverity.INFO,\n                                message=\u003Cspan class=\"hljs-string\">'Table may be missing header row'\u003C/span>,\n                                file_path=file_path,\n                                line_number=table_start,\n                                context=line,\n                                fix_suggestion=\u003Cspan class=\"hljs-string\">'Add header row with | --- | separators'\u003C/span>\n                            ))\n            \u003Cspan class=\"hljs-keyword\">elif\u003C/span> in_table \u003Cspan class=\"hljs-keyword\">and\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> \u003Cspan class=\"hljs-string\">'|'\u003C/span> \u003Cspan class=\"hljs-keyword\">in\u003C/span> line:\n                in_table = \u003Cspan class=\"hljs-literal\">False\u003C/span>\n                table_start = \u003Cspan class=\"hljs-literal\">None\u003C/span>\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">generate_report\u003C/span>(\u003Cspan class=\"hljs-params\">self\u003C/span>) -> \u003Cspan class=\"hljs-type\">Dict\u003C/span>:\n        \u003Cspan class=\"hljs-string\">"""Generate comprehensive validation report"""\u003C/span>\n        total_results = \u003Cspan class=\"hljs-built_in\">len\u003C/span>(self.results)\n        \n        \u003Cspan class=\"hljs-comment\"># Count by severity\u003C/span>\n        severity_counts = {\n            ValidationSeverity.ERROR: \u003Cspan class=\"hljs-number\">0\u003C/span>,\n            ValidationSeverity.WARNING: \u003Cspan class=\"hljs-number\">0\u003C/span>,\n            ValidationSeverity.INFO: \u003Cspan class=\"hljs-number\">0\u003C/span>\n        }\n        \n        \u003Cspan class=\"hljs-comment\"># Count by rule\u003C/span>\n        rule_counts = {}\n        \n        \u003Cspan class=\"hljs-comment\"># Group by file\u003C/span>\n        file_results = {}\n        \n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> result \u003Cspan class=\"hljs-keyword\">in\u003C/span> self.results:\n            severity_counts[result.severity] += \u003Cspan class=\"hljs-number\">1\u003C/span>\n            rule_counts[result.rule_id] = rule_counts.get(result.rule_id, \u003Cspan class=\"hljs-number\">0\u003C/span>) + \u003Cspan class=\"hljs-number\">1\u003C/span>\n            \n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> result.file_path \u003Cspan class=\"hljs-keyword\">not\u003C/span> \u003Cspan class=\"hljs-keyword\">in\u003C/span> file_results:\n                file_results[result.file_path] = []\n            file_results[result.file_path].append(result)\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> {\n            \u003Cspan class=\"hljs-string\">'summary'\u003C/span>: {\n                \u003Cspan class=\"hljs-string\">'total_issues'\u003C/span>: total_results,\n                \u003Cspan class=\"hljs-string\">'errors'\u003C/span>: severity_counts[ValidationSeverity.ERROR],\n                \u003Cspan class=\"hljs-string\">'warnings'\u003C/span>: severity_counts[ValidationSeverity.WARNING],\n                \u003Cspan class=\"hljs-string\">'info'\u003C/span>: severity_counts[ValidationSeverity.INFO],\n                \u003Cspan class=\"hljs-string\">'files_with_issues'\u003C/span>: \u003Cspan class=\"hljs-built_in\">len\u003C/span>(file_results),\n                \u003Cspan class=\"hljs-string\">'most_common_issues'\u003C/span>: \u003Cspan class=\"hljs-built_in\">sorted\u003C/span>(rule_counts.items(), key=\u003Cspan class=\"hljs-keyword\">lambda\u003C/span> x: x[\u003Cspan class=\"hljs-number\">1\u003C/span>], reverse=\u003Cspan class=\"hljs-literal\">True\u003C/span>)[:\u003Cspan class=\"hljs-number\">5\u003C/span>]\n            },\n            \u003Cspan class=\"hljs-string\">'results_by_file'\u003C/span>: file_results,\n            \u003Cspan class=\"hljs-string\">'all_results'\u003C/span>: [self.result_to_dict(r) \u003Cspan class=\"hljs-keyword\">for\u003C/span> r \u003Cspan class=\"hljs-keyword\">in\u003C/span> self.results],\n            \u003Cspan class=\"hljs-string\">'generated_at'\u003C/span>: datetime.now().isoformat()\n        }\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">result_to_dict\u003C/span>(\u003Cspan class=\"hljs-params\">self, result: ValidationResult\u003C/span>) -> \u003Cspan class=\"hljs-type\">Dict\u003C/span>:\n        \u003Cspan class=\"hljs-string\">"""Convert ValidationResult to dictionary"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> {\n            \u003Cspan class=\"hljs-string\">'rule_id'\u003C/span>: result.rule_id,\n            \u003Cspan class=\"hljs-string\">'severity'\u003C/span>: result.severity.value,\n            \u003Cspan class=\"hljs-string\">'message'\u003C/span>: result.message,\n            \u003Cspan class=\"hljs-string\">'file_path'\u003C/span>: result.file_path,\n            \u003Cspan class=\"hljs-string\">'line_number'\u003C/span>: result.line_number,\n            \u003Cspan class=\"hljs-string\">'column'\u003C/span>: result.column,\n            \u003Cspan class=\"hljs-string\">'context'\u003C/span>: result.context,\n            \u003Cspan class=\"hljs-string\">'fix_suggestion'\u003C/span>: result.fix_suggestion\n        }\n\n\u003Cspan class=\"hljs-comment\"># CLI interface\u003C/span>\n\u003Cspan class=\"hljs-keyword\">if\u003C/span> __name__ == \u003Cspan class=\"hljs-string\">"__main__"\u003C/span>:\n    \u003Cspan class=\"hljs-keyword\">import\u003C/span> argparse\n    \n    parser = argparse.ArgumentParser(description=\u003Cspan class=\"hljs-string\">'Validate Markdown content'\u003C/span>)\n    parser.add_argument(\u003Cspan class=\"hljs-string\">'files'\u003C/span>, nargs=\u003Cspan class=\"hljs-string\">'+'\u003C/span>, \u003Cspan class=\"hljs-built_in\">help\u003C/span>=\u003Cspan class=\"hljs-string\">'Files to validate'\u003C/span>)\n    parser.add_argument(\u003Cspan class=\"hljs-string\">'--config'\u003C/span>, \u003Cspan class=\"hljs-string\">'-c'\u003C/span>, \u003Cspan class=\"hljs-built_in\">help\u003C/span>=\u003Cspan class=\"hljs-string\">'Configuration file path'\u003C/span>)\n    parser.add_argument(\u003Cspan class=\"hljs-string\">'--output'\u003C/span>, \u003Cspan class=\"hljs-string\">'-o'\u003C/span>, \u003Cspan class=\"hljs-built_in\">help\u003C/span>=\u003Cspan class=\"hljs-string\">'Output file path'\u003C/span>)\n    parser.add_argument(\u003Cspan class=\"hljs-string\">'--format'\u003C/span>, choices=[\u003Cspan class=\"hljs-string\">'json'\u003C/span>, \u003Cspan class=\"hljs-string\">'text'\u003C/span>], default=\u003Cspan class=\"hljs-string\">'text'\u003C/span>, \u003Cspan class=\"hljs-built_in\">help\u003C/span>=\u003Cspan class=\"hljs-string\">'Output format'\u003C/span>)\n    parser.add_argument(\u003Cspan class=\"hljs-string\">'--severity'\u003C/span>, choices=[\u003Cspan class=\"hljs-string\">'error'\u003C/span>, \u003Cspan class=\"hljs-string\">'warning'\u003C/span>, \u003Cspan class=\"hljs-string\">'info'\u003C/span>], default=\u003Cspan class=\"hljs-string\">'info'\u003C/span>, \u003Cspan class=\"hljs-built_in\">help\u003C/span>=\u003Cspan class=\"hljs-string\">'Minimum severity to report'\u003C/span>)\n    \n    args = parser.parse_args()\n    \n    validator = ContentValidator(args.config \u003Cspan class=\"hljs-keyword\">or\u003C/span> \u003Cspan class=\"hljs-string\">'validation_config.yaml'\u003C/span>)\n    \n    all_results = []\n    \u003Cspan class=\"hljs-keyword\">for\u003C/span> file_path \u003Cspan class=\"hljs-keyword\">in\u003C/span> args.files:\n        results = validator.validate_file(file_path)\n        all_results.extend(results)\n    \n    \u003Cspan class=\"hljs-comment\"># Filter by severity\u003C/span>\n    severity_order = {\u003Cspan class=\"hljs-string\">'error'\u003C/span>: \u003Cspan class=\"hljs-number\">0\u003C/span>, \u003Cspan class=\"hljs-string\">'warning'\u003C/span>: \u003Cspan class=\"hljs-number\">1\u003C/span>, \u003Cspan class=\"hljs-string\">'info'\u003C/span>: \u003Cspan class=\"hljs-number\">2\u003C/span>}\n    min_severity = severity_order[args.severity]\n    \n    filtered_results = [r \u003Cspan class=\"hljs-keyword\">for\u003C/span> r \u003Cspan class=\"hljs-keyword\">in\u003C/span> all_results \u003Cspan class=\"hljs-keyword\">if\u003C/span> severity_order[r.severity.value] <= min_severity]\n    \n    \u003Cspan class=\"hljs-keyword\">if\u003C/span> args.\u003Cspan class=\"hljs-built_in\">format\u003C/span> == \u003Cspan class=\"hljs-string\">'json'\u003C/span>:\n        validator.results = filtered_results\n        report = validator.generate_report()\n        output = json.dumps(report, indent=\u003Cspan class=\"hljs-number\">2\u003C/span>)\n    \u003Cspan class=\"hljs-keyword\">else\u003C/span>:\n        output_lines = []\n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> result \u003Cspan class=\"hljs-keyword\">in\u003C/span> filtered_results:\n            line = \u003Cspan class=\"hljs-string\">f"\u003Cspan class=\"hljs-subst\">{result.file_path}\u003C/span>:\u003Cspan class=\"hljs-subst\">{result.line_number \u003Cspan class=\"hljs-keyword\">or\u003C/span> \u003Cspan class=\"hljs-number\">0\u003C/span>}\u003C/span>: \u003Cspan class=\"hljs-subst\">{result.severity.value}\u003C/span>: \u003Cspan class=\"hljs-subst\">{result.message}\u003C/span>"\u003C/span>\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> result.context:\n                line += \u003Cspan class=\"hljs-string\">f" (context: \u003Cspan class=\"hljs-subst\">{result.context}\u003C/span>)"\u003C/span>\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> result.fix_suggestion:\n                line += \u003Cspan class=\"hljs-string\">f" (fix: \u003Cspan class=\"hljs-subst\">{result.fix_suggestion}\u003C/span>)"\u003C/span>\n            output_lines.append(line)\n        output = \u003Cspan class=\"hljs-string\">'\\n'\u003C/span>.join(output_lines)\n    \n    \u003Cspan class=\"hljs-keyword\">if\u003C/span> args.output:\n        \u003Cspan class=\"hljs-keyword\">with\u003C/span> \u003Cspan class=\"hljs-built_in\">open\u003C/span>(args.output, \u003Cspan class=\"hljs-string\">'w'\u003C/span>) \u003Cspan class=\"hljs-keyword\">as\u003C/span> f:\n            f.write(output)\n    \u003Cspan class=\"hljs-keyword\">else\u003C/span>:\n        \u003Cspan class=\"hljs-built_in\">print\u003C/span>(output)\n\u003C/code>\u003C/pre>\u003Ch3 id=\"advanced-validation-rules-engine\">Advanced Validation Rules Engine\u003C/h3>\n\u003Cp>Creating extensible validation systems with custom rule definitions:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-comment\"># validation_config.yaml - Comprehensive validation configuration\u003C/span>\n\u003Cspan class=\"hljs-attr\">rules:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">frontmatter:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">enabled:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">required_fields:\u003C/span> [\u003Cspan class=\"hljs-string\">'title'\u003C/span>, \u003Cspan class=\"hljs-string\">'description'\u003C/span>, \u003Cspan class=\"hljs-string\">'date'\u003C/span>, \u003Cspan class=\"hljs-string\">'author'\u003C/span>]\n    \u003Cspan class=\"hljs-attr\">optional_fields:\u003C/span> [\u003Cspan class=\"hljs-string\">'keywords'\u003C/span>, \u003Cspan class=\"hljs-string\">'category'\u003C/span>, \u003Cspan class=\"hljs-string\">'tags'\u003C/span>, \u003Cspan class=\"hljs-string\">'image'\u003C/span>, \u003Cspan class=\"hljs-string\">'layout'\u003C/span>]\n    \u003Cspan class=\"hljs-attr\">field_validation:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">title:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">max_length:\u003C/span> \u003Cspan class=\"hljs-number\">100\u003C/span>\n        \u003Cspan class=\"hljs-attr\">min_length:\u003C/span> \u003Cspan class=\"hljs-number\">10\u003C/span>\n        \u003Cspan class=\"hljs-attr\">pattern:\u003C/span> \u003Cspan class=\"hljs-string\">'^[A-Z].*[^.]$'\u003C/span>  \u003Cspan class=\"hljs-comment\"># Start with capital, no trailing period\u003C/span>\n        \u003Cspan class=\"hljs-attr\">no_generic_words:\u003C/span> [\u003Cspan class=\"hljs-string\">'Guide'\u003C/span>, \u003Cspan class=\"hljs-string\">'Tutorial'\u003C/span>, \u003Cspan class=\"hljs-string\">'Documentation'\u003C/span>]\n      \u003Cspan class=\"hljs-attr\">description:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">max_length:\u003C/span> \u003Cspan class=\"hljs-number\">200\u003C/span>\n        \u003Cspan class=\"hljs-attr\">min_length:\u003C/span> \u003Cspan class=\"hljs-number\">50\u003C/span>\n        \u003Cspan class=\"hljs-attr\">unique_across_site:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">date:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">format:\u003C/span> \u003Cspan class=\"hljs-string\">'%Y-%m-%d'\u003C/span>\n        \u003Cspan class=\"hljs-attr\">not_future:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n        \u003Cspan class=\"hljs-attr\">not_older_than_days:\u003C/span> \u003Cspan class=\"hljs-number\">3650\u003C/span>  \u003Cspan class=\"hljs-comment\"># 10 years\u003C/span>\n      \u003Cspan class=\"hljs-attr\">keywords:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">min_count:\u003C/span> \u003Cspan class=\"hljs-number\">3\u003C/span>\n        \u003Cspan class=\"hljs-attr\">max_count:\u003C/span> \u003Cspan class=\"hljs-number\">12\u003C/span>\n        \u003Cspan class=\"hljs-attr\">lowercase_only:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n        \u003Cspan class=\"hljs-attr\">no_duplicates:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">category:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">allowed_values:\u003C/span> [\u003Cspan class=\"hljs-string\">'Tutorial'\u003C/span>, \u003Cspan class=\"hljs-string\">'Guide'\u003C/span>, \u003Cspan class=\"hljs-string\">'Reference'\u003C/span>, \u003Cspan class=\"hljs-string\">'Blog'\u003C/span>, \u003Cspan class=\"hljs-string\">'News'\u003C/span>]\n      \u003Cspan class=\"hljs-attr\">author:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">required_format:\u003C/span> \u003Cspan class=\"hljs-string\">'First Last'\u003C/span>\n        \u003Cspan class=\"hljs-attr\">validate_against_team_list:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n\n  \u003Cspan class=\"hljs-attr\">content_quality:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">enabled:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">readability:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">min_flesch_reading_ease:\u003C/span> \u003Cspan class=\"hljs-number\">30\u003C/span>\n      \u003Cspan class=\"hljs-attr\">max_flesch_reading_ease:\u003C/span> \u003Cspan class=\"hljs-number\">90\u003C/span>\n      \u003Cspan class=\"hljs-attr\">warn_complex_sentences:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">max_sentence_length:\u003C/span> \u003Cspan class=\"hljs-number\">25\u003C/span>\n    \u003Cspan class=\"hljs-attr\">structure:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">max_paragraph_length:\u003C/span> \u003Cspan class=\"hljs-number\">150\u003C/span>\n      \u003Cspan class=\"hljs-attr\">require_introduction_paragraph:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">require_conclusion_paragraph:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">max_heading_depth:\u003C/span> \u003Cspan class=\"hljs-number\">6\u003C/span>\n      \u003Cspan class=\"hljs-attr\">balanced_content_distribution:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">terminology:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">consistent_spelling:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">technical_terms_glossary:\u003C/span> \u003Cspan class=\"hljs-string\">'glossary.yaml'\u003C/span>\n      \u003Cspan class=\"hljs-attr\">brand_terms_consistency:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">forbidden_terms:\u003C/span> [\u003Cspan class=\"hljs-string\">'obviously'\u003C/span>, \u003Cspan class=\"hljs-string\">'simply'\u003C/span>, \u003Cspan class=\"hljs-string\">'just'\u003C/span>, \u003Cspan class=\"hljs-string\">'easy'\u003C/span>]\n\n  \u003Cspan class=\"hljs-attr\">links:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">enabled:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">internal_links:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">check_existence:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">allow_fragments:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">validate_anchors:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">prefer_relative_paths:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">warn_external_looking_internal:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">external_links:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">check_accessibility:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">timeout:\u003C/span> \u003Cspan class=\"hljs-number\">15\u003C/span>\n      \u003Cspan class=\"hljs-attr\">retry_count:\u003C/span> \u003Cspan class=\"hljs-number\">3\u003C/span>\n      \u003Cspan class=\"hljs-attr\">check_redirects:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">warn_shortened_urls:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">allowed_domains:\u003C/span> []\n      \u003Cspan class=\"hljs-attr\">blocked_domains:\u003C/span> [\u003Cspan class=\"hljs-string\">'bit.ly'\u003C/span>, \u003Cspan class=\"hljs-string\">'tinyurl.com'\u003C/span>, \u003Cspan class=\"hljs-string\">'t.co'\u003C/span>]\n      \u003Cspan class=\"hljs-attr\">check_ssl_certificates:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n\n  \u003Cspan class=\"hljs-attr\">images:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">enabled:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">accessibility:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">require_alt_text:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">alt_text_min_length:\u003C/span> \u003Cspan class=\"hljs-number\">5\u003C/span>\n      \u003Cspan class=\"hljs-attr\">alt_text_max_length:\u003C/span> \u003Cspan class=\"hljs-number\">125\u003C/span>\n      \u003Cspan class=\"hljs-attr\">no_filename_alt_text:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">descriptive_alt_text_check:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">technical:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">max_file_size_mb:\u003C/span> \u003Cspan class=\"hljs-number\">5\u003C/span>\n      \u003Cspan class=\"hljs-attr\">allowed_formats:\u003C/span> [\u003Cspan class=\"hljs-string\">'jpg'\u003C/span>, \u003Cspan class=\"hljs-string\">'jpeg'\u003C/span>, \u003Cspan class=\"hljs-string\">'png'\u003C/span>, \u003Cspan class=\"hljs-string\">'gif'\u003C/span>, \u003Cspan class=\"hljs-string\">'webp'\u003C/span>, \u003Cspan class=\"hljs-string\">'svg'\u003C/span>]\n      \u003Cspan class=\"hljs-attr\">min_dimensions:\u003C/span> [\u003Cspan class=\"hljs-number\">200\u003C/span>, \u003Cspan class=\"hljs-number\">200\u003C/span>]\n      \u003Cspan class=\"hljs-attr\">max_dimensions:\u003C/span> [\u003Cspan class=\"hljs-number\">2000\u003C/span>, \u003Cspan class=\"hljs-number\">2000\u003C/span>]\n      \u003Cspan class=\"hljs-attr\">check_image_optimization:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">require_responsive_images:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">organization:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">preferred_directory:\u003C/span> \u003Cspan class=\"hljs-string\">'assets/images'\u003C/span>\n      \u003Cspan class=\"hljs-attr\">naming_convention:\u003C/span> \u003Cspan class=\"hljs-string\">'kebab-case'\u003C/span>\n      \u003Cspan class=\"hljs-attr\">require_organized_subdirectories:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n\n  \u003Cspan class=\"hljs-attr\">code_blocks:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">enabled:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">syntax:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">require_language_tags:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">validate_syntax_highlighting:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">supported_languages:\u003C/span> [\u003Cspan class=\"hljs-string\">'javascript'\u003C/span>, \u003Cspan class=\"hljs-string\">'python'\u003C/span>, \u003Cspan class=\"hljs-string\">'bash'\u003C/span>, \u003Cspan class=\"hljs-string\">'yaml'\u003C/span>, \u003Cspan class=\"hljs-string\">'json'\u003C/span>, \u003Cspan class=\"hljs-string\">'html'\u003C/span>, \u003Cspan class=\"hljs-string\">'css'\u003C/span>, \u003Cspan class=\"hljs-string\">'sql'\u003C/span>]\n      \u003Cspan class=\"hljs-attr\">warn_unsupported_languages:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">security:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">no_hardcoded_secrets:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">no_personal_information:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">warn_production_urls:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">scan_for_vulnerabilities:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">style:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">max_line_length:\u003C/span> \u003Cspan class=\"hljs-number\">120\u003C/span>\n      \u003Cspan class=\"hljs-attr\">consistent_indentation:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">no_trailing_whitespace:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">require_comments_for_complex_code:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n\n  \u003Cspan class=\"hljs-attr\">accessibility:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">enabled:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">headings:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">proper_hierarchy:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">descriptive_text:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">no_generic_headings:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">max_heading_length:\u003C/span> \u003Cspan class=\"hljs-number\">60\u003C/span>\n    \u003Cspan class=\"hljs-attr\">links:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">descriptive_text:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">no_generic_link_text:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">context_independent:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">keyboard_accessible:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">tables:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">require_headers:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">require_captions:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">proper_markup:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">responsive_design:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">media:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">alt_text_required:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">captions_for_videos:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">transcripts_for_audio:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n\n  \u003Cspan class=\"hljs-attr\">seo_optimization:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">enabled:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">meta_tags:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">title_length:\u003C/span> [\u003Cspan class=\"hljs-number\">30\u003C/span>, \u003Cspan class=\"hljs-number\">60\u003C/span>]\n      \u003Cspan class=\"hljs-attr\">description_length:\u003C/span> [\u003Cspan class=\"hljs-number\">120\u003C/span>, \u003Cspan class=\"hljs-number\">160\u003C/span>]\n      \u003Cspan class=\"hljs-attr\">keywords_relevance_check:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">unique_titles_across_site:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">content:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">keyword_density_check:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">heading_keyword_optimization:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">internal_linking_score:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">content_freshness_warnings:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">technical:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">structured_data_validation:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">canonical_urls:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">og_tags_validation:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">twitter_cards_validation:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n\n  \u003Cspan class=\"hljs-attr\">performance:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">enabled:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">file_sizes:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">max_markdown_size_kb:\u003C/span> \u003Cspan class=\"hljs-number\">500\u003C/span>\n      \u003Cspan class=\"hljs-attr\">warn_large_files:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">images:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">optimization_check:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">format_recommendations:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">lazy_loading_suggestions:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">external_resources:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">minimize_external_requests:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">cdn_usage_recommendations:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n\n\u003Cspan class=\"hljs-attr\">custom_rules:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">team_specific:\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">'brand_consistency'\u003C/span>\n      \u003Cspan class=\"hljs-attr\">description:\u003C/span> \u003Cspan class=\"hljs-string\">'Check for consistent brand terminology'\u003C/span>\n      \u003Cspan class=\"hljs-attr\">pattern:\u003C/span> \u003Cspan class=\"hljs-string\">'(?i)(our product|the platform|this tool)'\u003C/span>\n      \u003Cspan class=\"hljs-attr\">suggestion:\u003C/span> \u003Cspan class=\"hljs-string\">'Use specific product names instead of generic terms'\u003C/span>\n      \u003Cspan class=\"hljs-attr\">severity:\u003C/span> \u003Cspan class=\"hljs-string\">'info'\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">'documentation_templates'\u003C/span>\n      \u003Cspan class=\"hljs-attr\">description:\u003C/span> \u003Cspan class=\"hljs-string\">'Ensure API documentation follows template structure'\u003C/span>\n      \u003Cspan class=\"hljs-attr\">applies_to:\u003C/span> \u003Cspan class=\"hljs-string\">'content/api/**/*.md'\u003C/span>\n      \u003Cspan class=\"hljs-attr\">required_sections:\u003C/span> [\u003Cspan class=\"hljs-string\">'Overview'\u003C/span>, \u003Cspan class=\"hljs-string\">'Parameters'\u003C/span>, \u003Cspan class=\"hljs-string\">'Response'\u003C/span>, \u003Cspan class=\"hljs-string\">'Examples'\u003C/span>]\n      \u003Cspan class=\"hljs-attr\">severity:\u003C/span> \u003Cspan class=\"hljs-string\">'warning'\u003C/span>\n\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">'changelog_format'\u003C/span>\n      \u003Cspan class=\"hljs-attr\">description:\u003C/span> \u003Cspan class=\"hljs-string\">'Validate changelog entry format'\u003C/span>\n      \u003Cspan class=\"hljs-attr\">applies_to:\u003C/span> \u003Cspan class=\"hljs-string\">'CHANGELOG.md'\u003C/span>\n      \u003Cspan class=\"hljs-attr\">entry_pattern:\u003C/span> \u003Cspan class=\"hljs-string\">'^## \\[\\d+\\.\\d+\\.\\d+\\] - \\d{4}-\\d{2}-\\d{2}$'\u003C/span>\n      \u003Cspan class=\"hljs-attr\">severity:\u003C/span> \u003Cspan class=\"hljs-string\">'error'\u003C/span>\n\n\u003Cspan class=\"hljs-attr\">file_patterns:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">include:\u003C/span> [\u003Cspan class=\"hljs-string\">'**/*.md'\u003C/span>, \u003Cspan class=\"hljs-string\">'**/*.markdown'\u003C/span>]\n  \u003Cspan class=\"hljs-attr\">exclude:\u003C/span> \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">'node_modules/**'\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">'.git/**'\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">'_site/**'\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">'vendor/**'\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">'**/README.md'\u003C/span>  \u003Cspan class=\"hljs-comment\"># Often have different standards\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">'docs/archive/**'\u003C/span>  \u003Cspan class=\"hljs-comment\"># Archived content\u003C/span>\n\n\u003Cspan class=\"hljs-attr\">output:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">formats:\u003C/span> [\u003Cspan class=\"hljs-string\">'json'\u003C/span>, \u003Cspan class=\"hljs-string\">'junit'\u003C/span>, \u003Cspan class=\"hljs-string\">'sarif'\u003C/span>, \u003Cspan class=\"hljs-string\">'checkstyle'\u003C/span>]\n  \u003Cspan class=\"hljs-attr\">console_output:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n  \u003Cspan class=\"hljs-attr\">detailed_reports:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n  \u003Cspan class=\"hljs-attr\">metrics_tracking:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n  \u003Cspan class=\"hljs-attr\">historical_comparison:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n  \n\u003Cspan class=\"hljs-attr\">quality_gates:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">max_errors:\u003C/span> \u003Cspan class=\"hljs-number\">0\u003C/span>\n  \u003Cspan class=\"hljs-attr\">max_warnings:\u003C/span> \u003Cspan class=\"hljs-number\">10\u003C/span>\n  \u003Cspan class=\"hljs-attr\">min_quality_score:\u003C/span> \u003Cspan class=\"hljs-number\">80\u003C/span>\n  \u003Cspan class=\"hljs-attr\">required_checks:\u003C/span> [\u003Cspan class=\"hljs-string\">'frontmatter'\u003C/span>, \u003Cspan class=\"hljs-string\">'links'\u003C/span>, \u003Cspan class=\"hljs-string\">'accessibility'\u003C/span>]\n\n\u003Cspan class=\"hljs-attr\">integrations:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">github:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">create_issues_for_errors:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">comment_on_pull_requests:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \u003Cspan class=\"hljs-attr\">status_checks:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n  \u003Cspan class=\"hljs-attr\">slack:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">webhook_url:\u003C/span> \u003Cspan class=\"hljs-string\">'${SLACK_WEBHOOK_URL}'\u003C/span>\n    \u003Cspan class=\"hljs-attr\">notify_on_quality_regression:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n  \u003Cspan class=\"hljs-attr\">email:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">recipients:\u003C/span> [\u003Cspan class=\"hljs-string\">'docs-team@company.com'\u003C/span>]\n    \u003Cspan class=\"hljs-attr\">daily_summary:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n\u003C/code>\u003C/pre>\u003Ch2 id=\"cicd-integration-and-automation\">CI/CD Integration and Automation\u003C/h2>\n\u003Ch3 id=\"github-actions-workflow\">GitHub Actions Workflow\u003C/h3>\n\u003Cp>Implementing automated validation in continuous integration pipelines:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-comment\"># .github/workflows/content-validation.yml - Comprehensive content validation workflow\u003C/span>\n\u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Content\u003C/span> \u003Cspan class=\"hljs-string\">Validation\u003C/span> \u003Cspan class=\"hljs-string\">and\u003C/span> \u003Cspan class=\"hljs-string\">Quality\u003C/span> \u003Cspan class=\"hljs-string\">Assurance\u003C/span>\n\n\u003Cspan class=\"hljs-attr\">on:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">push:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">branches:\u003C/span> [\u003Cspan class=\"hljs-string\">main\u003C/span>, \u003Cspan class=\"hljs-string\">develop\u003C/span>]\n    \u003Cspan class=\"hljs-attr\">paths:\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">'**/*.md'\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">'**/*.markdown'\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">'content/**'\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">'docs/**'\u003C/span>\n  \u003Cspan class=\"hljs-attr\">pull_request:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">branches:\u003C/span> [\u003Cspan class=\"hljs-string\">main\u003C/span>, \u003Cspan class=\"hljs-string\">develop\u003C/span>]\n    \u003Cspan class=\"hljs-attr\">paths:\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">'**/*.md'\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">'**/*.markdown'\u003C/span> \n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">'content/**'\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">'docs/**'\u003C/span>\n  \u003Cspan class=\"hljs-attr\">schedule:\u003C/span>\n    \u003Cspan class=\"hljs-comment\"># Run comprehensive validation weekly\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">cron:\u003C/span> \u003Cspan class=\"hljs-string\">'0 2 * * 1'\u003C/span>\n\n\u003Cspan class=\"hljs-attr\">env:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">NODE_VERSION:\u003C/span> \u003Cspan class=\"hljs-string\">'18'\u003C/span>\n  \u003Cspan class=\"hljs-attr\">PYTHON_VERSION:\u003C/span> \u003Cspan class=\"hljs-string\">'3.9'\u003C/span>\n\n\u003Cspan class=\"hljs-attr\">jobs:\u003C/span>\n  \u003Cspan class=\"hljs-comment\"># Fast validation for quick feedback\u003C/span>\n  \u003Cspan class=\"hljs-attr\">quick-validation:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">runs-on:\u003C/span> \u003Cspan class=\"hljs-string\">ubuntu-latest\u003C/span>\n    \u003Cspan class=\"hljs-attr\">if:\u003C/span> \u003Cspan class=\"hljs-string\">github.event_name\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'pull_request'\u003C/span>\n    \n    \u003Cspan class=\"hljs-attr\">steps:\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Checkout\u003C/span> \u003Cspan class=\"hljs-string\">repository\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/checkout@v4\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">fetch-depth:\u003C/span> \u003Cspan class=\"hljs-number\">2\u003C/span>  \u003Cspan class=\"hljs-comment\"># Need depth for changed files detection\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Setup\u003C/span> \u003Cspan class=\"hljs-string\">Python\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/setup-python@v4\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">python-version:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">env.PYTHON_VERSION\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n        \u003Cspan class=\"hljs-attr\">cache:\u003C/span> \u003Cspan class=\"hljs-string\">'pip'\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Install\u003C/span> \u003Cspan class=\"hljs-string\">validation\u003C/span> \u003Cspan class=\"hljs-string\">tools\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        pip install -r requirements-validation.txt\n        npm install -g markdownlint-cli\n        npm install -g markdown-link-check\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Get\u003C/span> \u003Cspan class=\"hljs-string\">changed\u003C/span> \u003Cspan class=\"hljs-string\">files\u003C/span>\n      \u003Cspan class=\"hljs-attr\">id:\u003C/span> \u003Cspan class=\"hljs-string\">changed-files\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">tj-actions/changed-files@v39\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">files:\u003C/span> \u003Cspan class=\"hljs-string\">|\n          **/*.md\n          **/*.markdown\n\u003C/span>        \u003Cspan class=\"hljs-attr\">files_ignore:\u003C/span> \u003Cspan class=\"hljs-string\">|\n          node_modules/**\n          .git/**\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Run\u003C/span> \u003Cspan class=\"hljs-string\">quick\u003C/span> \u003Cspan class=\"hljs-string\">validation\u003C/span> \u003Cspan class=\"hljs-string\">on\u003C/span> \u003Cspan class=\"hljs-string\">changed\u003C/span> \u003Cspan class=\"hljs-string\">files\u003C/span>\n      \u003Cspan class=\"hljs-attr\">if:\u003C/span> \u003Cspan class=\"hljs-string\">steps.changed-files.outputs.any_changed\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'true'\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        echo "Changed files: ${{ steps.changed-files.outputs.all_changed_files }}"\n        python scripts/markdown_validator.py \\\n          --config validation_config.yaml \\\n          --format json \\\n          --output validation_results.json \\\n          --severity warning \\\n          ${{ steps.changed-files.outputs.all_changed_files }}\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Upload\u003C/span> \u003Cspan class=\"hljs-string\">validation\u003C/span> \u003Cspan class=\"hljs-string\">results\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/upload-artifact@v3\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">quick-validation-results\u003C/span>\n        \u003Cspan class=\"hljs-attr\">path:\u003C/span> \u003Cspan class=\"hljs-string\">validation_results.json\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Comment\u003C/span> \u003Cspan class=\"hljs-string\">PR\u003C/span> \u003Cspan class=\"hljs-string\">with\u003C/span> \u003Cspan class=\"hljs-string\">results\u003C/span>\n      \u003Cspan class=\"hljs-attr\">if:\u003C/span> \u003Cspan class=\"hljs-string\">github.event_name\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'pull_request'\u003C/span> \u003Cspan class=\"hljs-string\">&&\u003C/span> \u003Cspan class=\"hljs-string\">steps.changed-files.outputs.any_changed\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'true'\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/github-script@v6\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">script:\u003C/span> \u003Cspan class=\"hljs-string\">|\n          const fs = require('fs');\n\u003C/span>          \n          \u003Cspan class=\"hljs-string\">try\u003C/span> {\n            \u003Cspan class=\"hljs-string\">const\u003C/span> \u003Cspan class=\"hljs-string\">results\u003C/span> \u003Cspan class=\"hljs-string\">=\u003C/span> \u003Cspan class=\"hljs-string\">JSON.parse(fs.readFileSync('validation_results.json'\u003C/span>, \u003Cspan class=\"hljs-string\">'utf8'\u003C/span>\u003Cspan class=\"hljs-string\">));\u003C/span>\n            \n            \u003Cspan class=\"hljs-string\">let\u003C/span> \u003Cspan class=\"hljs-string\">comment\u003C/span> \u003Cspan class=\"hljs-string\">=\u003C/span> \u003Cspan class=\"hljs-string\">'## 📝 Content Validation Results\\n\\n'\u003C/span>\u003Cspan class=\"hljs-string\">;\u003C/span>\n            \u003Cspan class=\"hljs-string\">comment\u003C/span> \u003Cspan class=\"hljs-string\">+=\u003C/span> \u003Cspan class=\"hljs-string\">`**Summary:**\\n`;\u003C/span>\n            \u003Cspan class=\"hljs-string\">comment\u003C/span> \u003Cspan class=\"hljs-string\">+=\u003C/span> \u003Cspan class=\"hljs-string\">`-\u003C/span> \u003Cspan class=\"hljs-attr\">Errors:\u003C/span> \u003Cspan class=\"hljs-string\">$\u003C/span>{\u003Cspan class=\"hljs-string\">results.summary.errors\u003C/span>}\u003Cspan class=\"hljs-string\">\\n`;\u003C/span>\n            \u003Cspan class=\"hljs-string\">comment\u003C/span> \u003Cspan class=\"hljs-string\">+=\u003C/span> \u003Cspan class=\"hljs-string\">`-\u003C/span> \u003Cspan class=\"hljs-attr\">Warnings:\u003C/span> \u003Cspan class=\"hljs-string\">$\u003C/span>{\u003Cspan class=\"hljs-string\">results.summary.warnings\u003C/span>}\u003Cspan class=\"hljs-string\">\\n`;\u003C/span>\n            \u003Cspan class=\"hljs-string\">comment\u003C/span> \u003Cspan class=\"hljs-string\">+=\u003C/span> \u003Cspan class=\"hljs-string\">`-\u003C/span> \u003Cspan class=\"hljs-attr\">Info:\u003C/span> \u003Cspan class=\"hljs-string\">$\u003C/span>{\u003Cspan class=\"hljs-string\">results.summary.info\u003C/span>}\u003Cspan class=\"hljs-string\">\\n`;\u003C/span>\n            \u003Cspan class=\"hljs-string\">comment\u003C/span> \u003Cspan class=\"hljs-string\">+=\u003C/span> \u003Cspan class=\"hljs-string\">`-\u003C/span> \u003Cspan class=\"hljs-attr\">Files checked:\u003C/span> \u003Cspan class=\"hljs-string\">$\u003C/span>{\u003Cspan class=\"hljs-string\">results.summary.files_with_issues\u003C/span>}\u003Cspan class=\"hljs-string\">\\n\\n`;\u003C/span>\n            \n            \u003Cspan class=\"hljs-string\">if\u003C/span> \u003Cspan class=\"hljs-string\">(results.summary.errors\u003C/span> \u003Cspan class=\"hljs-string\">>\u003C/span> \u003Cspan class=\"hljs-number\">0\u003C/span>\u003Cspan class=\"hljs-string\">)\u003C/span> {\n              \u003Cspan class=\"hljs-string\">comment\u003C/span> \u003Cspan class=\"hljs-string\">+=\u003C/span> \u003Cspan class=\"hljs-string\">'❌ **Validation failed** - please fix errors before merging.\\n\\n'\u003C/span>\u003Cspan class=\"hljs-string\">;\u003C/span>\n            } \u003Cspan class=\"hljs-string\">else\u003C/span> \u003Cspan class=\"hljs-string\">if\u003C/span> \u003Cspan class=\"hljs-string\">(results.summary.warnings\u003C/span> \u003Cspan class=\"hljs-string\">>\u003C/span> \u003Cspan class=\"hljs-number\">0\u003C/span>\u003Cspan class=\"hljs-string\">)\u003C/span> {\n              \u003Cspan class=\"hljs-string\">comment\u003C/span> \u003Cspan class=\"hljs-string\">+=\u003C/span> \u003Cspan class=\"hljs-string\">'⚠️ **Validation passed with warnings** - consider addressing warnings.\\n\\n'\u003C/span>\u003Cspan class=\"hljs-string\">;\u003C/span>\n            } \u003Cspan class=\"hljs-string\">else\u003C/span> {\n              \u003Cspan class=\"hljs-string\">comment\u003C/span> \u003Cspan class=\"hljs-string\">+=\u003C/span> \u003Cspan class=\"hljs-string\">'✅ **All validations passed!**\\n\\n'\u003C/span>\u003Cspan class=\"hljs-string\">;\u003C/span>\n            }\n            \n            \u003Cspan class=\"hljs-string\">if\u003C/span> \u003Cspan class=\"hljs-string\">(results.summary.most_common_issues.length\u003C/span> \u003Cspan class=\"hljs-string\">>\u003C/span> \u003Cspan class=\"hljs-number\">0\u003C/span>\u003Cspan class=\"hljs-string\">)\u003C/span> {\n              \u003Cspan class=\"hljs-string\">comment\u003C/span> \u003Cspan class=\"hljs-string\">+=\u003C/span> \u003Cspan class=\"hljs-string\">'**Most common issues:**\\n'\u003C/span>\u003Cspan class=\"hljs-string\">;\u003C/span>\n              \u003Cspan class=\"hljs-string\">results.summary.most_common_issues.forEach((\u003C/span>[\u003Cspan class=\"hljs-string\">rule\u003C/span>, \u003Cspan class=\"hljs-string\">count\u003C/span>]\u003Cspan class=\"hljs-string\">)\u003C/span> \u003Cspan class=\"hljs-string\">=>\u003C/span> {\n                \u003Cspan class=\"hljs-string\">comment\u003C/span> \u003Cspan class=\"hljs-string\">+=\u003C/span> \u003Cspan class=\"hljs-string\">`-\u003C/span> \u003Cspan class=\"hljs-string\">$\u003C/span>{\u003Cspan class=\"hljs-string\">rule\u003C/span>}\u003Cspan class=\"hljs-string\">:\u003C/span> \u003Cspan class=\"hljs-string\">$\u003C/span>{\u003Cspan class=\"hljs-string\">count\u003C/span>} \u003Cspan class=\"hljs-string\">occurrences\\n`;\u003C/span>\n              }\u003Cspan class=\"hljs-string\">);\u003C/span>\n            }\n            \n            \u003Cspan class=\"hljs-string\">//\u003C/span> \u003Cspan class=\"hljs-string\">Add\u003C/span> \u003Cspan class=\"hljs-string\">details\u003C/span> \u003Cspan class=\"hljs-string\">for\u003C/span> \u003Cspan class=\"hljs-string\">errors\u003C/span> \u003Cspan class=\"hljs-string\">and\u003C/span> \u003Cspan class=\"hljs-string\">warnings\u003C/span>\n            \u003Cspan class=\"hljs-string\">const\u003C/span> \u003Cspan class=\"hljs-string\">importantResults\u003C/span> \u003Cspan class=\"hljs-string\">=\u003C/span> \u003Cspan class=\"hljs-string\">results.all_results.filter(r\u003C/span> \u003Cspan class=\"hljs-string\">=>\u003C/span> \n              \u003Cspan class=\"hljs-string\">r.severity\u003C/span> \u003Cspan class=\"hljs-string\">===\u003C/span> \u003Cspan class=\"hljs-string\">'error'\u003C/span> \u003Cspan class=\"hljs-string\">||\u003C/span> \u003Cspan class=\"hljs-string\">r.severity\u003C/span> \u003Cspan class=\"hljs-string\">===\u003C/span> \u003Cspan class=\"hljs-string\">'warning'\u003C/span>\n            \u003Cspan class=\"hljs-string\">);\u003C/span>\n            \n            \u003Cspan class=\"hljs-string\">if\u003C/span> \u003Cspan class=\"hljs-string\">(importantResults.length\u003C/span> \u003Cspan class=\"hljs-string\">>\u003C/span> \u003Cspan class=\"hljs-number\">0\u003C/span> \u003Cspan class=\"hljs-string\">&&\u003C/span> \u003Cspan class=\"hljs-string\">importantResults.length\u003C/span> \u003Cspan class=\"hljs-string\"><=\u003C/span> \u003Cspan class=\"hljs-number\">10\u003C/span>\u003Cspan class=\"hljs-string\">)\u003C/span> {\n              \u003Cspan class=\"hljs-string\">comment\u003C/span> \u003Cspan class=\"hljs-string\">+=\u003C/span> \u003Cspan class=\"hljs-string\">'\\n**Issues found:**\\n'\u003C/span>\u003Cspan class=\"hljs-string\">;\u003C/span>\n              \u003Cspan class=\"hljs-string\">importantResults.forEach(result\u003C/span> \u003Cspan class=\"hljs-string\">=>\u003C/span> {\n                \u003Cspan class=\"hljs-string\">const\u003C/span> \u003Cspan class=\"hljs-string\">icon\u003C/span> \u003Cspan class=\"hljs-string\">=\u003C/span> \u003Cspan class=\"hljs-string\">result.severity\u003C/span> \u003Cspan class=\"hljs-string\">===\u003C/span> \u003Cspan class=\"hljs-string\">'error'\u003C/span> \u003Cspan class=\"hljs-string\">?\u003C/span> \u003Cspan class=\"hljs-string\">'❌'\u003C/span> \u003Cspan class=\"hljs-string\">:\u003C/span> \u003Cspan class=\"hljs-string\">'⚠️'\u003C/span>\u003Cspan class=\"hljs-string\">;\u003C/span>\n                \u003Cspan class=\"hljs-string\">const\u003C/span> \u003Cspan class=\"hljs-string\">location\u003C/span> \u003Cspan class=\"hljs-string\">=\u003C/span> \u003Cspan class=\"hljs-string\">result.line_number\u003C/span> \u003Cspan class=\"hljs-string\">?\u003C/span> \u003Cspan class=\"hljs-string\">`:$\u003C/span>{\u003Cspan class=\"hljs-string\">result.line_number\u003C/span>}\u003Cspan class=\"hljs-string\">`\u003C/span> \u003Cspan class=\"hljs-string\">:\u003C/span> \u003Cspan class=\"hljs-string\">''\u003C/span>\u003Cspan class=\"hljs-string\">;\u003C/span>\n                \u003Cspan class=\"hljs-string\">comment\u003C/span> \u003Cspan class=\"hljs-string\">+=\u003C/span> \u003Cspan class=\"hljs-string\">`$\u003C/span>{\u003Cspan class=\"hljs-string\">icon\u003C/span>} \u003Cspan class=\"hljs-string\">**$\u003C/span>{\u003Cspan class=\"hljs-string\">result.file_path\u003C/span>}\u003Cspan class=\"hljs-string\">$\u003C/span>{\u003Cspan class=\"hljs-string\">location\u003C/span>}\u003Cspan class=\"hljs-string\">**:\u003C/span> \u003Cspan class=\"hljs-string\">$\u003C/span>{\u003Cspan class=\"hljs-string\">result.message\u003C/span>}\u003Cspan class=\"hljs-string\">\\n`;\u003C/span>\n                \u003Cspan class=\"hljs-string\">if\u003C/span> \u003Cspan class=\"hljs-string\">(result.fix_suggestion)\u003C/span> {\n                  \u003Cspan class=\"hljs-string\">comment\u003C/span> \u003Cspan class=\"hljs-string\">+=\u003C/span> \u003Cspan class=\"hljs-string\">`\u003C/span>   \u003Cspan class=\"hljs-string\">💡\u003C/span> \u003Cspan class=\"hljs-string\">$\u003C/span>{\u003Cspan class=\"hljs-string\">result.fix_suggestion\u003C/span>}\u003Cspan class=\"hljs-string\">\\n`;\u003C/span>\n                }\n              }\u003Cspan class=\"hljs-string\">);\u003C/span>\n            } \u003Cspan class=\"hljs-string\">else\u003C/span> \u003Cspan class=\"hljs-string\">if\u003C/span> \u003Cspan class=\"hljs-string\">(importantResults.length\u003C/span> \u003Cspan class=\"hljs-string\">>\u003C/span> \u003Cspan class=\"hljs-number\">10\u003C/span>\u003Cspan class=\"hljs-string\">)\u003C/span> {\n              \u003Cspan class=\"hljs-string\">comment\u003C/span> \u003Cspan class=\"hljs-string\">+=\u003C/span> \u003Cspan class=\"hljs-string\">`\\n**$\u003C/span>{\u003Cspan class=\"hljs-string\">importantResults.length\u003C/span>} \u003Cspan class=\"hljs-string\">issues\u003C/span> \u003Cspan class=\"hljs-string\">found**\u003C/span> \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">see\u003C/span> \u003Cspan class=\"hljs-string\">full\u003C/span> \u003Cspan class=\"hljs-string\">report\u003C/span> \u003Cspan class=\"hljs-string\">in\u003C/span> \u003Cspan class=\"hljs-string\">workflow\u003C/span> \u003Cspan class=\"hljs-string\">artifacts.\\n`;\u003C/span>\n            }\n            \n            \u003Cspan class=\"hljs-string\">github.rest.issues.createComment(\u003C/span>{\n              \u003Cspan class=\"hljs-attr\">issue_number:\u003C/span> \u003Cspan class=\"hljs-string\">context.issue.number\u003C/span>,\n              \u003Cspan class=\"hljs-attr\">owner:\u003C/span> \u003Cspan class=\"hljs-string\">context.repo.owner\u003C/span>,\n              \u003Cspan class=\"hljs-attr\">repo:\u003C/span> \u003Cspan class=\"hljs-string\">context.repo.repo\u003C/span>,\n              \u003Cspan class=\"hljs-attr\">body:\u003C/span> \u003Cspan class=\"hljs-string\">comment\u003C/span>\n            }\u003Cspan class=\"hljs-string\">);\u003C/span>\n          } \u003Cspan class=\"hljs-string\">catch\u003C/span> \u003Cspan class=\"hljs-string\">(error)\u003C/span> {\n            \u003Cspan class=\"hljs-string\">console.error('Failed\u003C/span> \u003Cspan class=\"hljs-string\">to\u003C/span> \u003Cspan class=\"hljs-string\">post\u003C/span> \u003Cspan class=\"hljs-string\">validation\u003C/span> \u003Cspan class=\"hljs-string\">results:'\u003C/span>, \u003Cspan class=\"hljs-string\">error);\u003C/span>\n          }\n\n  \u003Cspan class=\"hljs-comment\"># Comprehensive validation for main branches and scheduled runs\u003C/span>\n  \u003Cspan class=\"hljs-attr\">comprehensive-validation:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">runs-on:\u003C/span> \u003Cspan class=\"hljs-string\">ubuntu-latest\u003C/span>\n    \u003Cspan class=\"hljs-attr\">if:\u003C/span> \u003Cspan class=\"hljs-string\">github.ref\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'refs/heads/main'\u003C/span> \u003Cspan class=\"hljs-string\">||\u003C/span> \u003Cspan class=\"hljs-string\">github.ref\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'refs/heads/develop'\u003C/span> \u003Cspan class=\"hljs-string\">||\u003C/span> \u003Cspan class=\"hljs-string\">github.event_name\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'schedule'\u003C/span>\n    \n    \u003Cspan class=\"hljs-attr\">steps:\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Checkout\u003C/span> \u003Cspan class=\"hljs-string\">repository\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/checkout@v4\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">fetch-depth:\u003C/span> \u003Cspan class=\"hljs-number\">0\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Setup\u003C/span> \u003Cspan class=\"hljs-string\">Python\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/setup-python@v4\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">python-version:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">env.PYTHON_VERSION\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n        \u003Cspan class=\"hljs-attr\">cache:\u003C/span> \u003Cspan class=\"hljs-string\">'pip'\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Setup\u003C/span> \u003Cspan class=\"hljs-string\">Node.js\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/setup-node@v4\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">node-version:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">env.NODE_VERSION\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n        \u003Cspan class=\"hljs-attr\">cache:\u003C/span> \u003Cspan class=\"hljs-string\">'npm'\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Install\u003C/span> \u003Cspan class=\"hljs-string\">comprehensive\u003C/span> \u003Cspan class=\"hljs-string\">validation\u003C/span> \u003Cspan class=\"hljs-string\">tools\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        # Python tools\n        pip install -r requirements-validation.txt\n        pip install textstat\n        pip install py-readability-metrics\n\u003C/span>        \n        \u003Cspan class=\"hljs-comment\"># Node.js tools\u003C/span>\n        \u003Cspan class=\"hljs-string\">npm\u003C/span> \u003Cspan class=\"hljs-string\">install\u003C/span> \u003Cspan class=\"hljs-string\">-g\u003C/span> \u003Cspan class=\"hljs-string\">markdownlint-cli\u003C/span>\n        \u003Cspan class=\"hljs-string\">npm\u003C/span> \u003Cspan class=\"hljs-string\">install\u003C/span> \u003Cspan class=\"hljs-string\">-g\u003C/span> \u003Cspan class=\"hljs-string\">markdown-link-check\u003C/span>\n        \u003Cspan class=\"hljs-string\">npm\u003C/span> \u003Cspan class=\"hljs-string\">install\u003C/span> \u003Cspan class=\"hljs-string\">-g\u003C/span> \u003Cspan class=\"hljs-string\">alex\u003C/span>\n        \u003Cspan class=\"hljs-string\">npm\u003C/span> \u003Cspan class=\"hljs-string\">install\u003C/span> \u003Cspan class=\"hljs-string\">-g\u003C/span> \u003Cspan class=\"hljs-string\">write-good\u003C/span>\n        \n        \u003Cspan class=\"hljs-comment\"># Additional tools\u003C/span>\n        \u003Cspan class=\"hljs-string\">wget\u003C/span> \u003Cspan class=\"hljs-string\">-O\u003C/span> \u003Cspan class=\"hljs-string\">vale.tar.gz\u003C/span> \u003Cspan class=\"hljs-string\">https://github.com/errata-ai/vale/releases/download/v2.25.0/vale_2.25.0_Linux_64-bit.tar.gz\u003C/span>\n        \u003Cspan class=\"hljs-string\">tar\u003C/span> \u003Cspan class=\"hljs-string\">-xzf\u003C/span> \u003Cspan class=\"hljs-string\">vale.tar.gz\u003C/span>\n        \u003Cspan class=\"hljs-string\">sudo\u003C/span> \u003Cspan class=\"hljs-string\">mv\u003C/span> \u003Cspan class=\"hljs-string\">vale\u003C/span> \u003Cspan class=\"hljs-string\">/usr/local/bin/\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Run\u003C/span> \u003Cspan class=\"hljs-string\">comprehensive\u003C/span> \u003Cspan class=\"hljs-string\">validation\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        python scripts/comprehensive_validator.py \\\n          --config validation_config.yaml \\\n          --output-dir validation-reports/ \\\n          --include-metrics \\\n          --generate-trends \\\n          --parallel-processing\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Run\u003C/span> \u003Cspan class=\"hljs-string\">external\u003C/span> \u003Cspan class=\"hljs-string\">tool\u003C/span> \u003Cspan class=\"hljs-string\">validations\u003C/span>\n      \u003Cspan class=\"hljs-attr\">continue-on-error:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        # Markdown linting\n        markdownlint --config .markdownlint.json "**/*.md" > validation-reports/markdownlint.txt || true\n\u003C/span>        \n        \u003Cspan class=\"hljs-comment\"># Link checking (external links only for comprehensive check)\u003C/span>\n        \u003Cspan class=\"hljs-string\">find\u003C/span> \u003Cspan class=\"hljs-string\">.\u003C/span> \u003Cspan class=\"hljs-string\">-name\u003C/span> \u003Cspan class=\"hljs-string\">"*.md"\u003C/span> \u003Cspan class=\"hljs-string\">-exec\u003C/span> \u003Cspan class=\"hljs-string\">markdown-link-check\u003C/span> {} \u003Cspan class=\"hljs-string\">\\;\u003C/span> \u003Cspan class=\"hljs-string\">>\u003C/span> \u003Cspan class=\"hljs-string\">validation-reports/link-check.txt\u003C/span> \u003Cspan class=\"hljs-string\">||\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n        \n        \u003Cspan class=\"hljs-comment\"># Prose linting\u003C/span>\n        \u003Cspan class=\"hljs-string\">alex\u003C/span> \u003Cspan class=\"hljs-string\">.\u003C/span> \u003Cspan class=\"hljs-string\">--why\u003C/span> \u003Cspan class=\"hljs-string\">>\u003C/span> \u003Cspan class=\"hljs-string\">validation-reports/alex-report.txt\u003C/span> \u003Cspan class=\"hljs-string\">||\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n        \u003Cspan class=\"hljs-string\">write-good\u003C/span> \u003Cspan class=\"hljs-string\">**/*.md\u003C/span> \u003Cspan class=\"hljs-string\">>\u003C/span> \u003Cspan class=\"hljs-string\">validation-reports/write-good.txt\u003C/span> \u003Cspan class=\"hljs-string\">||\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n        \n        \u003Cspan class=\"hljs-comment\"># Style and grammar checking\u003C/span>\n        \u003Cspan class=\"hljs-string\">vale\u003C/span> \u003Cspan class=\"hljs-string\">--config\u003C/span> \u003Cspan class=\"hljs-string\">vale.ini\u003C/span> \u003Cspan class=\"hljs-string\">.\u003C/span> \u003Cspan class=\"hljs-string\">>\u003C/span> \u003Cspan class=\"hljs-string\">validation-reports/vale-report.txt\u003C/span> \u003Cspan class=\"hljs-string\">||\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Generate\u003C/span> \u003Cspan class=\"hljs-string\">quality\u003C/span> \u003Cspan class=\"hljs-string\">metrics\u003C/span> \u003Cspan class=\"hljs-string\">dashboard\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        python scripts/generate_quality_dashboard.py \\\n          --input validation-reports/ \\\n          --output validation-reports/dashboard.html \\\n          --include-trends \\\n          --compare-with-baseline\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Upload\u003C/span> \u003Cspan class=\"hljs-string\">comprehensive\u003C/span> \u003Cspan class=\"hljs-string\">reports\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/upload-artifact@v3\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">comprehensive-validation-reports\u003C/span>\n        \u003Cspan class=\"hljs-attr\">path:\u003C/span> \u003Cspan class=\"hljs-string\">validation-reports/\u003C/span>\n        \u003Cspan class=\"hljs-attr\">retention-days:\u003C/span> \u003Cspan class=\"hljs-number\">30\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Update\u003C/span> \u003Cspan class=\"hljs-string\">quality\u003C/span> \u003Cspan class=\"hljs-string\">metrics\u003C/span>\n      \u003Cspan class=\"hljs-attr\">if:\u003C/span> \u003Cspan class=\"hljs-string\">github.ref\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'refs/heads/main'\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        python scripts/update_quality_metrics.py \\\n          --results validation-reports/comprehensive-results.json \\\n          --metrics-file docs/quality-metrics.json \\\n          --trend-data docs/quality-trends.json\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Commit\u003C/span> \u003Cspan class=\"hljs-string\">updated\u003C/span> \u003Cspan class=\"hljs-string\">metrics\u003C/span>\n      \u003Cspan class=\"hljs-attr\">if:\u003C/span> \u003Cspan class=\"hljs-string\">github.ref\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'refs/heads/main'\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        git config --local user.email "action@github.com"\n        git config --local user.name "GitHub Action"\n\u003C/span>        \n        \u003Cspan class=\"hljs-string\">if\u003C/span> \u003Cspan class=\"hljs-string\">git\u003C/span> \u003Cspan class=\"hljs-string\">diff\u003C/span> \u003Cspan class=\"hljs-string\">--quiet\u003C/span> \u003Cspan class=\"hljs-string\">docs/quality-metrics.json\u003C/span> \u003Cspan class=\"hljs-string\">docs/quality-trends.json;\u003C/span> \u003Cspan class=\"hljs-string\">then\u003C/span>\n          \u003Cspan class=\"hljs-string\">echo\u003C/span> \u003Cspan class=\"hljs-string\">"No metrics changes to commit"\u003C/span>\n        \u003Cspan class=\"hljs-string\">else\u003C/span>\n          \u003Cspan class=\"hljs-string\">git\u003C/span> \u003Cspan class=\"hljs-string\">add\u003C/span> \u003Cspan class=\"hljs-string\">docs/quality-metrics.json\u003C/span> \u003Cspan class=\"hljs-string\">docs/quality-trends.json\u003C/span>\n          \u003Cspan class=\"hljs-string\">git\u003C/span> \u003Cspan class=\"hljs-string\">commit\u003C/span> \u003Cspan class=\"hljs-string\">-m\u003C/span> \u003Cspan class=\"hljs-string\">"Update documentation quality metrics [skip ci]"\u003C/span>\n          \u003Cspan class=\"hljs-string\">git\u003C/span> \u003Cspan class=\"hljs-string\">push\u003C/span>\n        \u003Cspan class=\"hljs-string\">fi\u003C/span>\n\n  \u003Cspan class=\"hljs-comment\"># Security and compliance scanning\u003C/span>\n  \u003Cspan class=\"hljs-attr\">security-validation:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">runs-on:\u003C/span> \u003Cspan class=\"hljs-string\">ubuntu-latest\u003C/span>\n    \u003Cspan class=\"hljs-attr\">if:\u003C/span> \u003Cspan class=\"hljs-string\">github.event_name\u003C/span> \u003Cspan class=\"hljs-type\">!=\u003C/span> \u003Cspan class=\"hljs-string\">'pull_request'\u003C/span>  \u003Cspan class=\"hljs-comment\"># Skip for PRs to avoid secrets exposure\u003C/span>\n    \n    \u003Cspan class=\"hljs-attr\">steps:\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Checkout\u003C/span> \u003Cspan class=\"hljs-string\">repository\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/checkout@v4\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Setup\u003C/span> \u003Cspan class=\"hljs-string\">Python\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/setup-python@v4\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">python-version:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">env.PYTHON_VERSION\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Install\u003C/span> \u003Cspan class=\"hljs-string\">security\u003C/span> \u003Cspan class=\"hljs-string\">scanning\u003C/span> \u003Cspan class=\"hljs-string\">tools\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        pip install detect-secrets\n        pip install bandit\n        npm install -g secretlint\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Scan\u003C/span> \u003Cspan class=\"hljs-string\">for\u003C/span> \u003Cspan class=\"hljs-string\">secrets\u003C/span> \u003Cspan class=\"hljs-string\">in\u003C/span> \u003Cspan class=\"hljs-string\">documentation\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        detect-secrets scan --all-files --baseline .secrets.baseline\n        secretlint "**/*.md" --format json --output security-scan.json || true\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Check\u003C/span> \u003Cspan class=\"hljs-string\">for\u003C/span> \u003Cspan class=\"hljs-string\">compliance\u003C/span> \u003Cspan class=\"hljs-string\">violations\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        python scripts/compliance_checker.py \\\n          --config compliance_config.yaml \\\n          --output compliance-report.json\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Upload\u003C/span> \u003Cspan class=\"hljs-string\">security\u003C/span> \u003Cspan class=\"hljs-string\">scan\u003C/span> \u003Cspan class=\"hljs-string\">results\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/upload-artifact@v3\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">security-scan-results\u003C/span>\n        \u003Cspan class=\"hljs-attr\">path:\u003C/span> \u003Cspan class=\"hljs-string\">|\n          security-scan.json\n          compliance-report.json\n\u003C/span>\n  \u003Cspan class=\"hljs-comment\"># Performance and optimization analysis\u003C/span>\n  \u003Cspan class=\"hljs-attr\">performance-analysis:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">runs-on:\u003C/span> \u003Cspan class=\"hljs-string\">ubuntu-latest\u003C/span>\n    \u003Cspan class=\"hljs-attr\">if:\u003C/span> \u003Cspan class=\"hljs-string\">github.event_name\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'schedule'\u003C/span>\n    \n    \u003Cspan class=\"hljs-attr\">steps:\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Checkout\u003C/span> \u003Cspan class=\"hljs-string\">repository\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/checkout@v4\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Setup\u003C/span> \u003Cspan class=\"hljs-string\">Python\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/setup-python@v4\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">python-version:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">env.PYTHON_VERSION\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Analyze\u003C/span> \u003Cspan class=\"hljs-string\">content\u003C/span> \u003Cspan class=\"hljs-string\">performance\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        python scripts/performance_analyzer.py \\\n          --input-dir . \\\n          --output performance-analysis.json \\\n          --check-file-sizes \\\n          --analyze-image-optimization \\\n          --check-external-dependencies\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Generate\u003C/span> \u003Cspan class=\"hljs-string\">optimization\u003C/span> \u003Cspan class=\"hljs-string\">recommendations\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        python scripts/optimization_recommender.py \\\n          --analysis performance-analysis.json \\\n          --output optimization-recommendations.md\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Create\u003C/span> \u003Cspan class=\"hljs-string\">optimization\u003C/span> \u003Cspan class=\"hljs-string\">issue\u003C/span>\n      \u003Cspan class=\"hljs-attr\">if:\u003C/span> \u003Cspan class=\"hljs-string\">github.event_name\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'schedule'\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/github-script@v6\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">script:\u003C/span> \u003Cspan class=\"hljs-string\">|\n          const fs = require('fs');\n\u003C/span>          \n          \u003Cspan class=\"hljs-string\">try\u003C/span> {\n            \u003Cspan class=\"hljs-string\">const\u003C/span> \u003Cspan class=\"hljs-string\">recommendations\u003C/span> \u003Cspan class=\"hljs-string\">=\u003C/span> \u003Cspan class=\"hljs-string\">fs.readFileSync('optimization-recommendations.md'\u003C/span>, \u003Cspan class=\"hljs-string\">'utf8'\u003C/span>\u003Cspan class=\"hljs-string\">);\u003C/span>\n            \n            \u003Cspan class=\"hljs-string\">if\u003C/span> \u003Cspan class=\"hljs-string\">(recommendations.trim())\u003C/span> {\n              \u003Cspan class=\"hljs-string\">await\u003C/span> \u003Cspan class=\"hljs-string\">github.rest.issues.create(\u003C/span>{\n                \u003Cspan class=\"hljs-attr\">owner:\u003C/span> \u003Cspan class=\"hljs-string\">context.repo.owner\u003C/span>,\n                \u003Cspan class=\"hljs-attr\">repo:\u003C/span> \u003Cspan class=\"hljs-string\">context.repo.repo\u003C/span>,\n                \u003Cspan class=\"hljs-attr\">title:\u003C/span> \u003Cspan class=\"hljs-string\">`📈\u003C/span> \u003Cspan class=\"hljs-string\">Weekly\u003C/span> \u003Cspan class=\"hljs-string\">Performance\u003C/span> \u003Cspan class=\"hljs-string\">Optimization\u003C/span> \u003Cspan class=\"hljs-string\">Recommendations\u003C/span> \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">$\u003C/span>{\u003Cspan class=\"hljs-string\">new\u003C/span> \u003Cspan class=\"hljs-string\">Date().toISOString().split('T')\u003C/span>[\u003Cspan class=\"hljs-number\">0\u003C/span>]}\u003Cspan class=\"hljs-string\">`\u003C/span>,\n                \u003Cspan class=\"hljs-attr\">body:\u003C/span> \u003Cspan class=\"hljs-string\">recommendations\u003C/span>,\n                \u003Cspan class=\"hljs-attr\">labels:\u003C/span> [\u003Cspan class=\"hljs-string\">'documentation'\u003C/span>, \u003Cspan class=\"hljs-string\">'performance'\u003C/span>, \u003Cspan class=\"hljs-string\">'automated'\u003C/span>]\n              }\u003Cspan class=\"hljs-string\">);\u003C/span>\n            }\n          } \u003Cspan class=\"hljs-string\">catch\u003C/span> \u003Cspan class=\"hljs-string\">(error)\u003C/span> {\n            \u003Cspan class=\"hljs-string\">console.error('Failed\u003C/span> \u003Cspan class=\"hljs-string\">to\u003C/span> \u003Cspan class=\"hljs-string\">create\u003C/span> \u003Cspan class=\"hljs-string\">optimization\u003C/span> \u003Cspan class=\"hljs-string\">issue:'\u003C/span>, \u003Cspan class=\"hljs-string\">error);\u003C/span>\n          }\n\n  \u003Cspan class=\"hljs-comment\"># Quality gates and deployment checks\u003C/span>\n  \u003Cspan class=\"hljs-attr\">quality-gates:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">runs-on:\u003C/span> \u003Cspan class=\"hljs-string\">ubuntu-latest\u003C/span>\n    \u003Cspan class=\"hljs-attr\">needs:\u003C/span> [\u003Cspan class=\"hljs-string\">quick-validation\u003C/span>, \u003Cspan class=\"hljs-string\">comprehensive-validation\u003C/span>]\n    \u003Cspan class=\"hljs-attr\">if:\u003C/span> \u003Cspan class=\"hljs-string\">always()\u003C/span> \u003Cspan class=\"hljs-string\">&&\u003C/span> \u003Cspan class=\"hljs-string\">(needs.quick-validation.result\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'success'\u003C/span> \u003Cspan class=\"hljs-string\">||\u003C/span> \u003Cspan class=\"hljs-string\">needs.comprehensive-validation.result\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'success'\u003C/span>\u003Cspan class=\"hljs-string\">)\u003C/span>\n    \n    \u003Cspan class=\"hljs-attr\">steps:\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Download\u003C/span> \u003Cspan class=\"hljs-string\">validation\u003C/span> \u003Cspan class=\"hljs-string\">results\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/download-artifact@v3\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">path:\u003C/span> \u003Cspan class=\"hljs-string\">validation-results/\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Check\u003C/span> \u003Cspan class=\"hljs-string\">quality\u003C/span> \u003Cspan class=\"hljs-string\">gates\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        python scripts/quality_gates_checker.py \\\n          --results-dir validation-results/ \\\n          --config validation_config.yaml \\\n          --output quality-gates.json\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Set\u003C/span> \u003Cspan class=\"hljs-string\">deployment\u003C/span> \u003Cspan class=\"hljs-string\">status\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/github-script@v6\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">script:\u003C/span> \u003Cspan class=\"hljs-string\">|\n          const fs = require('fs');\n\u003C/span>          \n          \u003Cspan class=\"hljs-string\">try\u003C/span> {\n            \u003Cspan class=\"hljs-string\">const\u003C/span> \u003Cspan class=\"hljs-string\">gates\u003C/span> \u003Cspan class=\"hljs-string\">=\u003C/span> \u003Cspan class=\"hljs-string\">JSON.parse(fs.readFileSync('quality-gates.json'\u003C/span>, \u003Cspan class=\"hljs-string\">'utf8'\u003C/span>\u003Cspan class=\"hljs-string\">));\u003C/span>\n            \n            \u003Cspan class=\"hljs-string\">const\u003C/span> \u003Cspan class=\"hljs-string\">state\u003C/span> \u003Cspan class=\"hljs-string\">=\u003C/span> \u003Cspan class=\"hljs-string\">gates.passed\u003C/span> \u003Cspan class=\"hljs-string\">?\u003C/span> \u003Cspan class=\"hljs-string\">'success'\u003C/span> \u003Cspan class=\"hljs-string\">:\u003C/span> \u003Cspan class=\"hljs-string\">'failure'\u003C/span>\u003Cspan class=\"hljs-string\">;\u003C/span>\n            \u003Cspan class=\"hljs-string\">const\u003C/span> \u003Cspan class=\"hljs-string\">description\u003C/span> \u003Cspan class=\"hljs-string\">=\u003C/span> \u003Cspan class=\"hljs-string\">gates.passed\u003C/span> \u003Cspan class=\"hljs-string\">?\u003C/span> \n              \u003Cspan class=\"hljs-string\">'All quality gates passed'\u003C/span> \u003Cspan class=\"hljs-string\">:\u003C/span> \n              \u003Cspan class=\"hljs-string\">`Quality\u003C/span> \u003Cspan class=\"hljs-attr\">gates failed:\u003C/span> \u003Cspan class=\"hljs-string\">$\u003C/span>{\u003Cspan class=\"hljs-string\">gates.failures.join('\u003C/span>, \u003Cspan class=\"hljs-string\">')}`;\n            \n            await github.rest.repos.createCommitStatus({\n              owner: context.repo.owner,\n              repo: context.repo.repo,\n              sha: context.sha,\n              state: state,\n              target_url: `${context.serverUrl}/${context.repo.owner}/${context.repo.repo}/actions/runs/${context.runId}`,\n              description: description,\n              context: '\u003C/span>\u003Cspan class=\"hljs-string\">Content\u003C/span> \u003Cspan class=\"hljs-string\">Quality\u003C/span> \u003Cspan class=\"hljs-string\">Gates'\u003C/span>\n            }\u003Cspan class=\"hljs-string\">);\u003C/span>\n            \n            \u003Cspan class=\"hljs-string\">core.setOutput('quality_gates_passed'\u003C/span>, \u003Cspan class=\"hljs-string\">gates.passed);\u003C/span>\n            \n            \u003Cspan class=\"hljs-string\">if\u003C/span> \u003Cspan class=\"hljs-string\">(!gates.passed)\u003C/span> {\n              \u003Cspan class=\"hljs-string\">core.setFailed(`Quality\u003C/span> \u003Cspan class=\"hljs-attr\">gates failed:\u003C/span> \u003Cspan class=\"hljs-string\">$\u003C/span>{\u003Cspan class=\"hljs-string\">gates.failures.join('\u003C/span>, \u003Cspan class=\"hljs-string\">')}`);\n            }\n          } catch (error) {\n            console.error('\u003C/span>\u003Cspan class=\"hljs-string\">Failed\u003C/span> \u003Cspan class=\"hljs-string\">to\u003C/span> \u003Cspan class=\"hljs-string\">process\u003C/span> \u003Cspan class=\"hljs-string\">quality\u003C/span> \u003Cspan class=\"hljs-string\">gates:'\u003C/span>, \u003Cspan class=\"hljs-string\">error);\u003C/span>\n            \u003Cspan class=\"hljs-string\">core.setFailed('Error\u003C/span> \u003Cspan class=\"hljs-string\">processing\u003C/span> \u003Cspan class=\"hljs-string\">quality\u003C/span> \u003Cspan class=\"hljs-string\">gates');\u003C/span>\n          }\n\u003C/code>\u003C/pre>\u003Ch2 id=\"integration-with-content-management\">Integration with Content Management\u003C/h2>\n\u003Cp>Content validation systems integrate seamlessly with modern documentation workflows. When combined with \u003Ca href=\"/blog/markdown-version-control-git-integration-complete-guide\">version control and Git integration systems\u003C/a>, automated validation ensures that content quality standards are maintained across collaborative development processes while providing immediate feedback to contributors.\u003C/p>\n\u003Cp>For comprehensive documentation systems, validation complements \u003Ca href=\"/blog/markdown-form-creation-input-validation-complete-guide\">form creation and user interaction features\u003C/a> by ensuring that generated content and user-contributed documentation maintains consistent quality standards and accessibility compliance across all content types.\u003C/p>\n\u003Cp>When building sophisticated content architectures, validation works effectively with \u003Ca href=\"/blog/markdown-auto-linking-url-detection-complete-guide\">automated content linking and cross-referencing systems\u003C/a> to maintain content integrity, validate link relationships, and ensure that automated content generation produces high-quality, maintainable documentation.\u003C/p>\n\u003Ch2 id=\"advanced-quality-metrics-and-reporting\">Advanced Quality Metrics and Reporting\u003C/h2>\n\u003Ch3 id=\"comprehensive-quality-dashboard\">Comprehensive Quality Dashboard\u003C/h3>\n\u003Cp>Building interactive dashboards for content quality monitoring:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-python\">\u003Cspan class=\"hljs-comment\"># quality_dashboard.py - Interactive quality metrics dashboard\u003C/span>\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> json\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> pandas \u003Cspan class=\"hljs-keyword\">as\u003C/span> pd\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> plotly.graph_objects \u003Cspan class=\"hljs-keyword\">as\u003C/span> go\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> plotly.express \u003Cspan class=\"hljs-keyword\">as\u003C/span> px\n\u003Cspan class=\"hljs-keyword\">from\u003C/span> plotly.subplots \u003Cspan class=\"hljs-keyword\">import\u003C/span> make_subplots\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> dash\n\u003Cspan class=\"hljs-keyword\">from\u003C/span> dash \u003Cspan class=\"hljs-keyword\">import\u003C/span> dcc, html, dash_table\n\u003Cspan class=\"hljs-keyword\">from\u003C/span> dash.dependencies \u003Cspan class=\"hljs-keyword\">import\u003C/span> Input, Output, State\n\u003Cspan class=\"hljs-keyword\">from\u003C/span> datetime \u003Cspan class=\"hljs-keyword\">import\u003C/span> datetime, timedelta\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> numpy \u003Cspan class=\"hljs-keyword\">as\u003C/span> np\n\u003Cspan class=\"hljs-keyword\">from\u003C/span> typing \u003Cspan class=\"hljs-keyword\">import\u003C/span> \u003Cspan class=\"hljs-type\">Dict\u003C/span>, \u003Cspan class=\"hljs-type\">List\u003C/span>, \u003Cspan class=\"hljs-type\">Any\u003C/span>\n\n\u003Cspan class=\"hljs-keyword\">class\u003C/span> \u003Cspan class=\"hljs-title class_\">QualityDashboard\u003C/span>:\n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">__init__\u003C/span>(\u003Cspan class=\"hljs-params\">self, metrics_file: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, trends_file: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\u003C/span>):\n        self.app = dash.Dash(__name__)\n        self.metrics_data = self.load_metrics(metrics_file)\n        self.trends_data = self.load_trends(trends_file)\n        self.setup_layout()\n        self.setup_callbacks()\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">load_metrics\u003C/span>(\u003Cspan class=\"hljs-params\">self, file_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\u003C/span>) -> \u003Cspan class=\"hljs-type\">Dict\u003C/span>:\n        \u003Cspan class=\"hljs-string\">"""Load current quality metrics"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">try\u003C/span>:\n            \u003Cspan class=\"hljs-keyword\">with\u003C/span> \u003Cspan class=\"hljs-built_in\">open\u003C/span>(file_path, \u003Cspan class=\"hljs-string\">'r'\u003C/span>) \u003Cspan class=\"hljs-keyword\">as\u003C/span> f:\n                \u003Cspan class=\"hljs-keyword\">return\u003C/span> json.load(f)\n        \u003Cspan class=\"hljs-keyword\">except\u003C/span> FileNotFoundError:\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span> self.get_default_metrics()\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">load_trends\u003C/span>(\u003Cspan class=\"hljs-params\">self, file_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\u003C/span>) -> \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-type\">Dict\u003C/span>]:\n        \u003Cspan class=\"hljs-string\">"""Load historical trend data"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">try\u003C/span>:\n            \u003Cspan class=\"hljs-keyword\">with\u003C/span> \u003Cspan class=\"hljs-built_in\">open\u003C/span>(file_path, \u003Cspan class=\"hljs-string\">'r'\u003C/span>) \u003Cspan class=\"hljs-keyword\">as\u003C/span> f:\n                \u003Cspan class=\"hljs-keyword\">return\u003C/span> json.load(f)\n        \u003Cspan class=\"hljs-keyword\">except\u003C/span> FileNotFoundError:\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span> []\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">get_default_metrics\u003C/span>(\u003Cspan class=\"hljs-params\">self\u003C/span>) -> \u003Cspan class=\"hljs-type\">Dict\u003C/span>:\n        \u003Cspan class=\"hljs-string\">"""Return default metrics structure"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> {\n            \u003Cspan class=\"hljs-string\">'overall_score'\u003C/span>: \u003Cspan class=\"hljs-number\">85\u003C/span>,\n            \u003Cspan class=\"hljs-string\">'total_files'\u003C/span>: \u003Cspan class=\"hljs-number\">0\u003C/span>,\n            \u003Cspan class=\"hljs-string\">'last_updated'\u003C/span>: datetime.now().isoformat(),\n            \u003Cspan class=\"hljs-string\">'categories'\u003C/span>: {\n                \u003Cspan class=\"hljs-string\">'content_quality'\u003C/span>: {\u003Cspan class=\"hljs-string\">'score'\u003C/span>: \u003Cspan class=\"hljs-number\">85\u003C/span>, \u003Cspan class=\"hljs-string\">'issues'\u003C/span>: \u003Cspan class=\"hljs-number\">0\u003C/span>, \u003Cspan class=\"hljs-string\">'weight'\u003C/span>: \u003Cspan class=\"hljs-number\">0.3\u003C/span>},\n                \u003Cspan class=\"hljs-string\">'accessibility'\u003C/span>: {\u003Cspan class=\"hljs-string\">'score'\u003C/span>: \u003Cspan class=\"hljs-number\">90\u003C/span>, \u003Cspan class=\"hljs-string\">'issues'\u003C/span>: \u003Cspan class=\"hljs-number\">0\u003C/span>, \u003Cspan class=\"hljs-string\">'weight'\u003C/span>: \u003Cspan class=\"hljs-number\">0.2\u003C/span>},\n                \u003Cspan class=\"hljs-string\">'seo'\u003C/span>: {\u003Cspan class=\"hljs-string\">'score'\u003C/span>: \u003Cspan class=\"hljs-number\">80\u003C/span>, \u003Cspan class=\"hljs-string\">'issues'\u003C/span>: \u003Cspan class=\"hljs-number\">0\u003C/span>, \u003Cspan class=\"hljs-string\">'weight'\u003C/span>: \u003Cspan class=\"hljs-number\">0.2\u003C/span>},\n                \u003Cspan class=\"hljs-string\">'technical'\u003C/span>: {\u003Cspan class=\"hljs-string\">'score'\u003C/span>: \u003Cspan class=\"hljs-number\">88\u003C/span>, \u003Cspan class=\"hljs-string\">'issues'\u003C/span>: \u003Cspan class=\"hljs-number\">0\u003C/span>, \u003Cspan class=\"hljs-string\">'weight'\u003C/span>: \u003Cspan class=\"hljs-number\">0.15\u003C/span>},\n                \u003Cspan class=\"hljs-string\">'security'\u003C/span>: {\u003Cspan class=\"hljs-string\">'score'\u003C/span>: \u003Cspan class=\"hljs-number\">95\u003C/span>, \u003Cspan class=\"hljs-string\">'issues'\u003C/span>: \u003Cspan class=\"hljs-number\">0\u003C/span>, \u003Cspan class=\"hljs-string\">'weight'\u003C/span>: \u003Cspan class=\"hljs-number\">0.15\u003C/span>}\n            },\n            \u003Cspan class=\"hljs-string\">'rule_performance'\u003C/span>: {},\n            \u003Cspan class=\"hljs-string\">'file_quality_distribution'\u003C/span>: {}\n        }\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">setup_layout\u003C/span>(\u003Cspan class=\"hljs-params\">self\u003C/span>):\n        \u003Cspan class=\"hljs-string\">"""Setup dashboard layout"""\u003C/span>\n        self.app.layout = html.Div([\n            \u003Cspan class=\"hljs-comment\"># Header\u003C/span>\n            html.Div([\n                html.H1(\u003Cspan class=\"hljs-string\">"📊 Documentation Quality Dashboard"\u003C/span>, \n                       className=\u003Cspan class=\"hljs-string\">"dashboard-title"\u003C/span>),\n                html.P(\u003Cspan class=\"hljs-string\">f"Last updated: \u003Cspan class=\"hljs-subst\">{self.metrics_data.get(\u003Cspan class=\"hljs-string\">'last_updated'\u003C/span>, \u003Cspan class=\"hljs-string\">'Unknown'\u003C/span>)}\u003C/span>"\u003C/span>, \n                      className=\u003Cspan class=\"hljs-string\">"last-updated"\u003C/span>),\n            ], className=\u003Cspan class=\"hljs-string\">"header-section"\u003C/span>),\n            \n            \u003Cspan class=\"hljs-comment\"># Summary Cards\u003C/span>\n            html.Div([\n                self.create_summary_card(\u003Cspan class=\"hljs-string\">"Overall Quality Score"\u003C/span>, \n                                       \u003Cspan class=\"hljs-string\">f"\u003Cspan class=\"hljs-subst\">{self.metrics_data.get(\u003Cspan class=\"hljs-string\">'overall_score'\u003C/span>, \u003Cspan class=\"hljs-number\">0\u003C/span>)}\u003C/span>%"\u003C/span>,\n                                       self.get_score_color(self.metrics_data.get(\u003Cspan class=\"hljs-string\">'overall_score'\u003C/span>, \u003Cspan class=\"hljs-number\">0\u003C/span>)),\n                                       \u003Cspan class=\"hljs-string\">"trending-up"\u003C/span>),\n                self.create_summary_card(\u003Cspan class=\"hljs-string\">"Total Files"\u003C/span>, \n                                       \u003Cspan class=\"hljs-built_in\">str\u003C/span>(self.metrics_data.get(\u003Cspan class=\"hljs-string\">'total_files'\u003C/span>, \u003Cspan class=\"hljs-number\">0\u003C/span>)),\n                                       \u003Cspan class=\"hljs-string\">"#3498db"\u003C/span>, \u003Cspan class=\"hljs-string\">"file-text"\u003C/span>),\n                self.create_summary_card(\u003Cspan class=\"hljs-string\">"Issues Found"\u003C/span>, \n                                       \u003Cspan class=\"hljs-built_in\">str\u003C/span>(self.calculate_total_issues()),\n                                       \u003Cspan class=\"hljs-string\">"#e74c3c"\u003C/span>, \u003Cspan class=\"hljs-string\">"alert-triangle"\u003C/span>),\n                self.create_summary_card(\u003Cspan class=\"hljs-string\">"Files Passing"\u003C/span>, \n                                       \u003Cspan class=\"hljs-string\">f"\u003Cspan class=\"hljs-subst\">{self.calculate_passing_percentage()}\u003C/span>%"\u003C/span>,\n                                       \u003Cspan class=\"hljs-string\">"#2ecc71"\u003C/span>, \u003Cspan class=\"hljs-string\">"check-circle"\u003C/span>),\n            ], className=\u003Cspan class=\"hljs-string\">"summary-cards"\u003C/span>),\n            \n            \u003Cspan class=\"hljs-comment\"># Quality Score Breakdown\u003C/span>\n            html.Div([\n                html.H2(\u003Cspan class=\"hljs-string\">"Quality Score Breakdown"\u003C/span>),\n                dcc.Graph(\u003Cspan class=\"hljs-built_in\">id\u003C/span>=\u003Cspan class=\"hljs-string\">"quality-breakdown-chart"\u003C/span>),\n            ], className=\u003Cspan class=\"hljs-string\">"chart-section"\u003C/span>),\n            \n            \u003Cspan class=\"hljs-comment\"># Trends Over Time\u003C/span>\n            html.Div([\n                html.H2(\u003Cspan class=\"hljs-string\">"Quality Trends"\u003C/span>),\n                dcc.Graph(\u003Cspan class=\"hljs-built_in\">id\u003C/span>=\u003Cspan class=\"hljs-string\">"trends-chart"\u003C/span>),\n            ], className=\u003Cspan class=\"hljs-string\">"chart-section"\u003C/span>),\n            \n            \u003Cspan class=\"hljs-comment\"># Rule Performance\u003C/span>\n            html.Div([\n                html.H2(\u003Cspan class=\"hljs-string\">"Validation Rule Performance"\u003C/span>),\n                dcc.Graph(\u003Cspan class=\"hljs-built_in\">id\u003C/span>=\u003Cspan class=\"hljs-string\">"rule-performance-chart"\u003C/span>),\n            ], className=\u003Cspan class=\"hljs-string\">"chart-section"\u003C/span>),\n            \n            \u003Cspan class=\"hljs-comment\"># File Quality Distribution\u003C/span>\n            html.Div([\n                html.H2(\u003Cspan class=\"hljs-string\">"File Quality Distribution"\u003C/span>),\n                dcc.Graph(\u003Cspan class=\"hljs-built_in\">id\u003C/span>=\u003Cspan class=\"hljs-string\">"file-quality-chart"\u003C/span>),\n            ], className=\u003Cspan class=\"hljs-string\">"chart-section"\u003C/span>),\n            \n            \u003Cspan class=\"hljs-comment\"># Detailed Issues Table\u003C/span>\n            html.Div([\n                html.H2(\u003Cspan class=\"hljs-string\">"Recent Issues"\u003C/span>),\n                dash_table.DataTable(\n                    \u003Cspan class=\"hljs-built_in\">id\u003C/span>=\u003Cspan class=\"hljs-string\">'issues-table'\u003C/span>,\n                    columns=[\n                        {\u003Cspan class=\"hljs-string\">"name"\u003C/span>: \u003Cspan class=\"hljs-string\">"File"\u003C/span>, \u003Cspan class=\"hljs-string\">"id"\u003C/span>: \u003Cspan class=\"hljs-string\">"file_path"\u003C/span>},\n                        {\u003Cspan class=\"hljs-string\">"name"\u003C/span>: \u003Cspan class=\"hljs-string\">"Rule"\u003C/span>, \u003Cspan class=\"hljs-string\">"id"\u003C/span>: \u003Cspan class=\"hljs-string\">"rule_id"\u003C/span>},\n                        {\u003Cspan class=\"hljs-string\">"name"\u003C/span>: \u003Cspan class=\"hljs-string\">"Severity"\u003C/span>, \u003Cspan class=\"hljs-string\">"id"\u003C/span>: \u003Cspan class=\"hljs-string\">"severity"\u003C/span>},\n                        {\u003Cspan class=\"hljs-string\">"name"\u003C/span>: \u003Cspan class=\"hljs-string\">"Message"\u003C/span>, \u003Cspan class=\"hljs-string\">"id"\u003C/span>: \u003Cspan class=\"hljs-string\">"message"\u003C/span>},\n                        {\u003Cspan class=\"hljs-string\">"name"\u003C/span>: \u003Cspan class=\"hljs-string\">"Fix Suggestion"\u003C/span>, \u003Cspan class=\"hljs-string\">"id"\u003C/span>: \u003Cspan class=\"hljs-string\">"fix_suggestion"\u003C/span>}\n                    ],\n                    data=self.get_recent_issues(),\n                    style_cell={\u003Cspan class=\"hljs-string\">'textAlign'\u003C/span>: \u003Cspan class=\"hljs-string\">'left'\u003C/span>, \u003Cspan class=\"hljs-string\">'overflow'\u003C/span>: \u003Cspan class=\"hljs-string\">'hidden'\u003C/span>, \n                              \u003Cspan class=\"hljs-string\">'textOverflow'\u003C/span>: \u003Cspan class=\"hljs-string\">'ellipsis'\u003C/span>, \u003Cspan class=\"hljs-string\">'maxWidth'\u003C/span>: \u003Cspan class=\"hljs-number\">0\u003C/span>},\n                    style_data_conditional=[\n                        {\n                            \u003Cspan class=\"hljs-string\">'if'\u003C/span>: {\u003Cspan class=\"hljs-string\">'filter_query'\u003C/span>: \u003Cspan class=\"hljs-string\">'{severity} = error'\u003C/span>},\n                            \u003Cspan class=\"hljs-string\">'backgroundColor'\u003C/span>: \u003Cspan class=\"hljs-string\">'#ffebee'\u003C/span>,\n                            \u003Cspan class=\"hljs-string\">'color'\u003C/span>: \u003Cspan class=\"hljs-string\">'black'\u003C/span>,\n                        },\n                        {\n                            \u003Cspan class=\"hljs-string\">'if'\u003C/span>: {\u003Cspan class=\"hljs-string\">'filter_query'\u003C/span>: \u003Cspan class=\"hljs-string\">'{severity} = warning'\u003C/span>},\n                            \u003Cspan class=\"hljs-string\">'backgroundColor'\u003C/span>: \u003Cspan class=\"hljs-string\">'#fff3e0'\u003C/span>,\n                            \u003Cspan class=\"hljs-string\">'color'\u003C/span>: \u003Cspan class=\"hljs-string\">'black'\u003C/span>,\n                        }\n                    ],\n                    page_size=\u003Cspan class=\"hljs-number\">20\u003C/span>,\n                    sort_action=\u003Cspan class=\"hljs-string\">"native"\u003C/span>,\n                    filter_action=\u003Cspan class=\"hljs-string\">"native"\u003C/span>\n                ),\n            ], className=\u003Cspan class=\"hljs-string\">"table-section"\u003C/span>),\n            \n        ], className=\u003Cspan class=\"hljs-string\">"dashboard-container"\u003C/span>)\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">create_summary_card\u003C/span>(\u003Cspan class=\"hljs-params\">self, title: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, value: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, color: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, icon: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\u003C/span>) -> html.Div:\n        \u003Cspan class=\"hljs-string\">"""Create a summary card component"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> html.Div([\n            html.Div([\n                html.I(className=\u003Cspan class=\"hljs-string\">f"fas fa-\u003Cspan class=\"hljs-subst\">{icon}\u003C/span>"\u003C/span>, style={\u003Cspan class=\"hljs-string\">"color"\u003C/span>: color, \u003Cspan class=\"hljs-string\">"fontSize"\u003C/span>: \u003Cspan class=\"hljs-string\">"2rem"\u003C/span>}),\n            ], className=\u003Cspan class=\"hljs-string\">"card-icon"\u003C/span>),\n            html.Div([\n                html.H3(title, className=\u003Cspan class=\"hljs-string\">"card-title"\u003C/span>),\n                html.P(value, className=\u003Cspan class=\"hljs-string\">"card-value"\u003C/span>, style={\u003Cspan class=\"hljs-string\">"color"\u003C/span>: color}),\n            ], className=\u003Cspan class=\"hljs-string\">"card-content"\u003C/span>),\n        ], className=\u003Cspan class=\"hljs-string\">"summary-card"\u003C/span>)\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">get_score_color\u003C/span>(\u003Cspan class=\"hljs-params\">self, score: \u003Cspan class=\"hljs-built_in\">int\u003C/span>\u003C/span>) -> \u003Cspan class=\"hljs-built_in\">str\u003C/span>:\n        \u003Cspan class=\"hljs-string\">"""Get color based on quality score"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> score >= \u003Cspan class=\"hljs-number\">90\u003C/span>:\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-string\">"#2ecc71"\u003C/span>  \u003Cspan class=\"hljs-comment\"># Green\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">elif\u003C/span> score >= \u003Cspan class=\"hljs-number\">75\u003C/span>:\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-string\">"#f39c12"\u003C/span>  \u003Cspan class=\"hljs-comment\"># Orange\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">else\u003C/span>:\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-string\">"#e74c3c"\u003C/span>  \u003Cspan class=\"hljs-comment\"># Red\u003C/span>\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">calculate_total_issues\u003C/span>(\u003Cspan class=\"hljs-params\">self\u003C/span>) -> \u003Cspan class=\"hljs-built_in\">int\u003C/span>:\n        \u003Cspan class=\"hljs-string\">"""Calculate total issues across all categories"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-built_in\">sum\u003C/span>(cat.get(\u003Cspan class=\"hljs-string\">'issues'\u003C/span>, \u003Cspan class=\"hljs-number\">0\u003C/span>) \u003Cspan class=\"hljs-keyword\">for\u003C/span> cat \u003Cspan class=\"hljs-keyword\">in\u003C/span> self.metrics_data.get(\u003Cspan class=\"hljs-string\">'categories'\u003C/span>, {}).values())\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">calculate_passing_percentage\u003C/span>(\u003Cspan class=\"hljs-params\">self\u003C/span>) -> \u003Cspan class=\"hljs-built_in\">int\u003C/span>:\n        \u003Cspan class=\"hljs-string\">"""Calculate percentage of files passing all checks"""\u003C/span>\n        file_dist = self.metrics_data.get(\u003Cspan class=\"hljs-string\">'file_quality_distribution'\u003C/span>, {})\n        total_files = \u003Cspan class=\"hljs-built_in\">sum\u003C/span>(file_dist.values()) \u003Cspan class=\"hljs-keyword\">if\u003C/span> file_dist \u003Cspan class=\"hljs-keyword\">else\u003C/span> \u003Cspan class=\"hljs-number\">1\u003C/span>\n        passing_files = file_dist.get(\u003Cspan class=\"hljs-string\">'excellent'\u003C/span>, \u003Cspan class=\"hljs-number\">0\u003C/span>) + file_dist.get(\u003Cspan class=\"hljs-string\">'good'\u003C/span>, \u003Cspan class=\"hljs-number\">0\u003C/span>)\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-built_in\">int\u003C/span>((passing_files / total_files) * \u003Cspan class=\"hljs-number\">100\u003C/span>) \u003Cspan class=\"hljs-keyword\">if\u003C/span> total_files > \u003Cspan class=\"hljs-number\">0\u003C/span> \u003Cspan class=\"hljs-keyword\">else\u003C/span> \u003Cspan class=\"hljs-number\">0\u003C/span>\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">get_recent_issues\u003C/span>(\u003Cspan class=\"hljs-params\">self\u003C/span>) -> \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-type\">Dict\u003C/span>]:\n        \u003Cspan class=\"hljs-string\">"""Get recent issues for the table"""\u003C/span>\n        \u003Cspan class=\"hljs-comment\"># This would typically come from a more detailed validation results file\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> [\n            {\n                \u003Cspan class=\"hljs-string\">"file_path"\u003C/span>: \u003Cspan class=\"hljs-string\">"docs/api/authentication.md"\u003C/span>,\n                \u003Cspan class=\"hljs-string\">"rule_id"\u003C/span>: \u003Cspan class=\"hljs-string\">"heading_too_long"\u003C/span>,\n                \u003Cspan class=\"hljs-string\">"severity"\u003C/span>: \u003Cspan class=\"hljs-string\">"warning"\u003C/span>,\n                \u003Cspan class=\"hljs-string\">"message"\u003C/span>: \u003Cspan class=\"hljs-string\">"Heading too long (85 chars, max 80)"\u003C/span>,\n                \u003Cspan class=\"hljs-string\">"fix_suggestion"\u003C/span>: \u003Cspan class=\"hljs-string\">"Shorten heading text"\u003C/span>\n            },\n            {\n                \u003Cspan class=\"hljs-string\">"file_path"\u003C/span>: \u003Cspan class=\"hljs-string\">"content/guides/getting-started.md"\u003C/span>,\n                \u003Cspan class=\"hljs-string\">"rule_id"\u003C/span>: \u003Cspan class=\"hljs-string\">"link_broken_external"\u003C/span>,\n                \u003Cspan class=\"hljs-string\">"severity"\u003C/span>: \u003Cspan class=\"hljs-string\">"error"\u003C/span>,\n                \u003Cspan class=\"hljs-string\">"message"\u003C/span>: \u003Cspan class=\"hljs-string\">"Broken external link: https://example.com/api"\u003C/span>,\n                \u003Cspan class=\"hljs-string\">"fix_suggestion"\u003C/span>: \u003Cspan class=\"hljs-string\">"Update or remove broken link"\u003C/span>\n            }\n        ]\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">setup_callbacks\u003C/span>(\u003Cspan class=\"hljs-params\">self\u003C/span>):\n        \u003Cspan class=\"hljs-string\">"""Setup interactive callbacks"""\u003C/span>\n        \n\u003Cspan class=\"hljs-meta\">        @self.app.callback(\u003Cspan class=\"hljs-params\">\n            Output(\u003Cspan class=\"hljs-params\">\u003Cspan class=\"hljs-string\">'quality-breakdown-chart'\u003C/span>, \u003Cspan class=\"hljs-string\">'figure'\u003C/span>\u003C/span>),\n            Input(\u003Cspan class=\"hljs-params\">\u003Cspan class=\"hljs-string\">'quality-breakdown-chart'\u003C/span>, \u003Cspan class=\"hljs-string\">'id'\u003C/span>\u003C/span>)\n        \u003C/span>)\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">update_quality_breakdown\u003C/span>(\u003Cspan class=\"hljs-params\">chart_id\u003C/span>):\n            categories = self.metrics_data.get(\u003Cspan class=\"hljs-string\">'categories'\u003C/span>, {})\n            \n            fig = go.Figure()\n            \n            \u003Cspan class=\"hljs-comment\"># Create radar chart for quality breakdown\u003C/span>\n            categories_list = \u003Cspan class=\"hljs-built_in\">list\u003C/span>(categories.keys())\n            scores = [categories[cat].get(\u003Cspan class=\"hljs-string\">'score'\u003C/span>, \u003Cspan class=\"hljs-number\">0\u003C/span>) \u003Cspan class=\"hljs-keyword\">for\u003C/span> cat \u003Cspan class=\"hljs-keyword\">in\u003C/span> categories_list]\n            \n            fig.add_trace(go.Scatterpolar(\n                r=scores,\n                theta=categories_list,\n                fill=\u003Cspan class=\"hljs-string\">'toself'\u003C/span>,\n                name=\u003Cspan class=\"hljs-string\">'Quality Scores'\u003C/span>,\n                line_color=\u003Cspan class=\"hljs-string\">'rgb(106, 81, 163)'\u003C/span>\n            ))\n            \n            fig.update_layout(\n                polar=\u003Cspan class=\"hljs-built_in\">dict\u003C/span>(\n                    radialaxis=\u003Cspan class=\"hljs-built_in\">dict\u003C/span>(\n                        visible=\u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                        \u003Cspan class=\"hljs-built_in\">range\u003C/span>=[\u003Cspan class=\"hljs-number\">0\u003C/span>, \u003Cspan class=\"hljs-number\">100\u003C/span>]\n                    )),\n                showlegend=\u003Cspan class=\"hljs-literal\">True\u003C/span>,\n                title=\u003Cspan class=\"hljs-string\">"Quality Score by Category"\u003C/span>\n            )\n            \n            \u003Cspan class=\"hljs-keyword\">return\u003C/span> fig\n        \n\u003Cspan class=\"hljs-meta\">        @self.app.callback(\u003Cspan class=\"hljs-params\">\n            Output(\u003Cspan class=\"hljs-params\">\u003Cspan class=\"hljs-string\">'trends-chart'\u003C/span>, \u003Cspan class=\"hljs-string\">'figure'\u003C/span>\u003C/span>),\n            Input(\u003Cspan class=\"hljs-params\">\u003Cspan class=\"hljs-string\">'trends-chart'\u003C/span>, \u003Cspan class=\"hljs-string\">'id'\u003C/span>\u003C/span>)\n        \u003C/span>)\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">update_trends_chart\u003C/span>(\u003Cspan class=\"hljs-params\">chart_id\u003C/span>):\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> self.trends_data:\n                \u003Cspan class=\"hljs-keyword\">return\u003C/span> go.Figure().add_annotation(\n                    text=\u003Cspan class=\"hljs-string\">"No trend data available"\u003C/span>, \n                    xref=\u003Cspan class=\"hljs-string\">"paper"\u003C/span>, yref=\u003Cspan class=\"hljs-string\">"paper"\u003C/span>,\n                    x=\u003Cspan class=\"hljs-number\">0.5\u003C/span>, y=\u003Cspan class=\"hljs-number\">0.5\u003C/span>, showarrow=\u003Cspan class=\"hljs-literal\">False\u003C/span>\n                )\n            \n            df = pd.DataFrame(self.trends_data)\n            df[\u003Cspan class=\"hljs-string\">'date'\u003C/span>] = pd.to_datetime(df[\u003Cspan class=\"hljs-string\">'date'\u003C/span>])\n            \n            fig = make_subplots(\n                rows=\u003Cspan class=\"hljs-number\">2\u003C/span>, cols=\u003Cspan class=\"hljs-number\">1\u003C/span>,\n                subplot_titles=(\u003Cspan class=\"hljs-string\">'Overall Quality Score'\u003C/span>, \u003Cspan class=\"hljs-string\">'Issues Count'\u003C/span>),\n                vertical_spacing=\u003Cspan class=\"hljs-number\">0.1\u003C/span>\n            )\n            \n            \u003Cspan class=\"hljs-comment\"># Overall score trend\u003C/span>\n            fig.add_trace(\n                go.Scatter(\n                    x=df[\u003Cspan class=\"hljs-string\">'date'\u003C/span>], \n                    y=df[\u003Cspan class=\"hljs-string\">'overall_score'\u003C/span>],\n                    mode=\u003Cspan class=\"hljs-string\">'lines+markers'\u003C/span>,\n                    name=\u003Cspan class=\"hljs-string\">'Quality Score'\u003C/span>,\n                    line=\u003Cspan class=\"hljs-built_in\">dict\u003C/span>(color=\u003Cspan class=\"hljs-string\">'#3498db'\u003C/span>, width=\u003Cspan class=\"hljs-number\">3\u003C/span>)\n                ),\n                row=\u003Cspan class=\"hljs-number\">1\u003C/span>, col=\u003Cspan class=\"hljs-number\">1\u003C/span>\n            )\n            \n            \u003Cspan class=\"hljs-comment\"># Issues count trend\u003C/span>\n            fig.add_trace(\n                go.Scatter(\n                    x=df[\u003Cspan class=\"hljs-string\">'date'\u003C/span>], \n                    y=df[\u003Cspan class=\"hljs-string\">'total_issues'\u003C/span>],\n                    mode=\u003Cspan class=\"hljs-string\">'lines+markers'\u003C/span>,\n                    name=\u003Cspan class=\"hljs-string\">'Total Issues'\u003C/span>,\n                    line=\u003Cspan class=\"hljs-built_in\">dict\u003C/span>(color=\u003Cspan class=\"hljs-string\">'#e74c3c'\u003C/span>, width=\u003Cspan class=\"hljs-number\">3\u003C/span>)\n                ),\n                row=\u003Cspan class=\"hljs-number\">2\u003C/span>, col=\u003Cspan class=\"hljs-number\">1\u003C/span>\n            )\n            \n            fig.update_layout(height=\u003Cspan class=\"hljs-number\">600\u003C/span>, showlegend=\u003Cspan class=\"hljs-literal\">True\u003C/span>)\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span> fig\n        \n\u003Cspan class=\"hljs-meta\">        @self.app.callback(\u003Cspan class=\"hljs-params\">\n            Output(\u003Cspan class=\"hljs-params\">\u003Cspan class=\"hljs-string\">'rule-performance-chart'\u003C/span>, \u003Cspan class=\"hljs-string\">'figure'\u003C/span>\u003C/span>),\n            Input(\u003Cspan class=\"hljs-params\">\u003Cspan class=\"hljs-string\">'rule-performance-chart'\u003C/span>, \u003Cspan class=\"hljs-string\">'id'\u003C/span>\u003C/span>)\n        \u003C/span>)\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">update_rule_performance\u003C/span>(\u003Cspan class=\"hljs-params\">chart_id\u003C/span>):\n            rule_perf = self.metrics_data.get(\u003Cspan class=\"hljs-string\">'rule_performance'\u003C/span>, {})\n            \n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> rule_perf:\n                \u003Cspan class=\"hljs-keyword\">return\u003C/span> go.Figure().add_annotation(\n                    text=\u003Cspan class=\"hljs-string\">"No rule performance data available"\u003C/span>, \n                    xref=\u003Cspan class=\"hljs-string\">"paper"\u003C/span>, yref=\u003Cspan class=\"hljs-string\">"paper"\u003C/span>,\n                    x=\u003Cspan class=\"hljs-number\">0.5\u003C/span>, y=\u003Cspan class=\"hljs-number\">0.5\u003C/span>, showarrow=\u003Cspan class=\"hljs-literal\">False\u003C/span>\n                )\n            \n            rules = \u003Cspan class=\"hljs-built_in\">list\u003C/span>(rule_perf.keys())\n            issue_counts = [rule_perf[rule].get(\u003Cspan class=\"hljs-string\">'issues'\u003C/span>, \u003Cspan class=\"hljs-number\">0\u003C/span>) \u003Cspan class=\"hljs-keyword\">for\u003C/span> rule \u003Cspan class=\"hljs-keyword\">in\u003C/span> rules]\n            \n            fig = go.Figure(data=[\n                go.Bar(\n                    x=issue_counts,\n                    y=rules,\n                    orientation=\u003Cspan class=\"hljs-string\">'h'\u003C/span>,\n                    marker_color=[\u003Cspan class=\"hljs-string\">'#e74c3c'\u003C/span> \u003Cspan class=\"hljs-keyword\">if\u003C/span> count > \u003Cspan class=\"hljs-number\">10\u003C/span> \u003Cspan class=\"hljs-keyword\">else\u003C/span> \u003Cspan class=\"hljs-string\">'#f39c12'\u003C/span> \u003Cspan class=\"hljs-keyword\">if\u003C/span> count > \u003Cspan class=\"hljs-number\">5\u003C/span> \u003Cspan class=\"hljs-keyword\">else\u003C/span> \u003Cspan class=\"hljs-string\">'#2ecc71'\u003C/span> \n                                 \u003Cspan class=\"hljs-keyword\">for\u003C/span> count \u003Cspan class=\"hljs-keyword\">in\u003C/span> issue_counts]\n                )\n            ])\n            \n            fig.update_layout(\n                title=\u003Cspan class=\"hljs-string\">"Issues by Validation Rule"\u003C/span>,\n                xaxis_title=\u003Cspan class=\"hljs-string\">"Number of Issues"\u003C/span>,\n                yaxis_title=\u003Cspan class=\"hljs-string\">"Validation Rule"\u003C/span>,\n                height=\u003Cspan class=\"hljs-built_in\">max\u003C/span>(\u003Cspan class=\"hljs-number\">400\u003C/span>, \u003Cspan class=\"hljs-built_in\">len\u003C/span>(rules) * \u003Cspan class=\"hljs-number\">30\u003C/span>)\n            )\n            \n            \u003Cspan class=\"hljs-keyword\">return\u003C/span> fig\n        \n\u003Cspan class=\"hljs-meta\">        @self.app.callback(\u003Cspan class=\"hljs-params\">\n            Output(\u003Cspan class=\"hljs-params\">\u003Cspan class=\"hljs-string\">'file-quality-chart'\u003C/span>, \u003Cspan class=\"hljs-string\">'figure'\u003C/span>\u003C/span>),\n            Input(\u003Cspan class=\"hljs-params\">\u003Cspan class=\"hljs-string\">'file-quality-chart'\u003C/span>, \u003Cspan class=\"hljs-string\">'id'\u003C/span>\u003C/span>)\n        \u003C/span>)\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">update_file_quality_chart\u003C/span>(\u003Cspan class=\"hljs-params\">chart_id\u003C/span>):\n            file_dist = self.metrics_data.get(\u003Cspan class=\"hljs-string\">'file_quality_distribution'\u003C/span>, {})\n            \n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> file_dist:\n                \u003Cspan class=\"hljs-keyword\">return\u003C/span> go.Figure().add_annotation(\n                    text=\u003Cspan class=\"hljs-string\">"No file quality distribution data available"\u003C/span>, \n                    xref=\u003Cspan class=\"hljs-string\">"paper"\u003C/span>, yref=\u003Cspan class=\"hljs-string\">"paper"\u003C/span>,\n                    x=\u003Cspan class=\"hljs-number\">0.5\u003C/span>, y=\u003Cspan class=\"hljs-number\">0.5\u003C/span>, showarrow=\u003Cspan class=\"hljs-literal\">False\u003C/span>\n                )\n            \n            labels = \u003Cspan class=\"hljs-built_in\">list\u003C/span>(file_dist.keys())\n            values = \u003Cspan class=\"hljs-built_in\">list\u003C/span>(file_dist.values())\n            colors = {\n                \u003Cspan class=\"hljs-string\">'excellent'\u003C/span>: \u003Cspan class=\"hljs-string\">'#2ecc71'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'good'\u003C/span>: \u003Cspan class=\"hljs-string\">'#3498db'\u003C/span>, \n                \u003Cspan class=\"hljs-string\">'fair'\u003C/span>: \u003Cspan class=\"hljs-string\">'#f39c12'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'poor'\u003C/span>: \u003Cspan class=\"hljs-string\">'#e74c3c'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'critical'\u003C/span>: \u003Cspan class=\"hljs-string\">'#8e44ad'\u003C/span>\n            }\n            \n            fig = go.Figure(data=[\n                go.Pie(\n                    labels=labels, \n                    values=values,\n                    marker_colors=[colors.get(label, \u003Cspan class=\"hljs-string\">'#95a5a6'\u003C/span>) \u003Cspan class=\"hljs-keyword\">for\u003C/span> label \u003Cspan class=\"hljs-keyword\">in\u003C/span> labels],\n                    hole=\u003Cspan class=\"hljs-number\">0.3\u003C/span>\n                )\n            ])\n            \n            fig.update_layout(\n                title=\u003Cspan class=\"hljs-string\">"File Quality Distribution"\u003C/span>,\n                annotations=[\u003Cspan class=\"hljs-built_in\">dict\u003C/span>(text=\u003Cspan class=\"hljs-string\">'Files'\u003C/span>, x=\u003Cspan class=\"hljs-number\">0.5\u003C/span>, y=\u003Cspan class=\"hljs-number\">0.5\u003C/span>, font_size=\u003Cspan class=\"hljs-number\">20\u003C/span>, showarrow=\u003Cspan class=\"hljs-literal\">False\u003C/span>)]\n            )\n            \n            \u003Cspan class=\"hljs-keyword\">return\u003C/span> fig\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">run\u003C/span>(\u003Cspan class=\"hljs-params\">self, debug: \u003Cspan class=\"hljs-built_in\">bool\u003C/span> = \u003Cspan class=\"hljs-literal\">True\u003C/span>, port: \u003Cspan class=\"hljs-built_in\">int\u003C/span> = \u003Cspan class=\"hljs-number\">8050\u003C/span>\u003C/span>):\n        \u003Cspan class=\"hljs-string\">"""Run the dashboard"""\u003C/span>\n        self.app.run_server(debug=debug, port=port)\n\n\u003Cspan class=\"hljs-comment\"># Usage\u003C/span>\n\u003Cspan class=\"hljs-keyword\">if\u003C/span> __name__ == \u003Cspan class=\"hljs-string\">"__main__"\u003C/span>:\n    dashboard = QualityDashboard(\u003Cspan class=\"hljs-string\">'docs/quality-metrics.json'\u003C/span>, \u003Cspan class=\"hljs-string\">'docs/quality-trends.json'\u003C/span>)\n    dashboard.run()\n\u003C/code>\u003C/pre>\u003Ch2 id=\"troubleshooting-common-validation-issues\">Troubleshooting Common Validation Issues\u003C/h2>\n\u003Ch3 id=\"performance-optimization-for-large-repositories\">Performance Optimization for Large Repositories\u003C/h3>\n\u003Cp>\u003Cstrong>Problem\u003C/strong>: Validation takes too long on large documentation repositories\u003C/p>\n\u003Cp>\u003Cstrong>Solutions\u003C/strong>:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-python\">\u003Cspan class=\"hljs-comment\"># performance_optimizer.py - Optimize validation for large repositories\u003C/span>\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> multiprocessing \u003Cspan class=\"hljs-keyword\">as\u003C/span> mp\n\u003Cspan class=\"hljs-keyword\">from\u003C/span> concurrent.futures \u003Cspan class=\"hljs-keyword\">import\u003C/span> ProcessPoolExecutor, ThreadPoolExecutor\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> asyncio\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> aiohttp\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> time\n\u003Cspan class=\"hljs-keyword\">from\u003C/span> functools \u003Cspan class=\"hljs-keyword\">import\u003C/span> lru_cache\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> pickle\n\u003Cspan class=\"hljs-keyword\">from\u003C/span> typing \u003Cspan class=\"hljs-keyword\">import\u003C/span> \u003Cspan class=\"hljs-type\">List\u003C/span>, \u003Cspan class=\"hljs-type\">Dict\u003C/span>, \u003Cspan class=\"hljs-type\">Any\u003C/span>\n\n\u003Cspan class=\"hljs-keyword\">class\u003C/span> \u003Cspan class=\"hljs-title class_\">OptimizedValidator\u003C/span>:\n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">__init__\u003C/span>(\u003Cspan class=\"hljs-params\">self, config: \u003Cspan class=\"hljs-type\">Dict\u003C/span>\u003C/span>):\n        self.config = config\n        self.cache = {}\n        self.session = \u003Cspan class=\"hljs-literal\">None\u003C/span>\n        \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">setup_caching\u003C/span>(\u003Cspan class=\"hljs-params\">self\u003C/span>):\n        \u003Cspan class=\"hljs-string\">"""Setup validation result caching"""\u003C/span>\n        \u003Cspan class=\"hljs-comment\"># File hash-based caching\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">import\u003C/span> hashlib\n        \n        \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">get_file_hash\u003C/span>(\u003Cspan class=\"hljs-params\">file_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\u003C/span>) -> \u003Cspan class=\"hljs-built_in\">str\u003C/span>:\n            \u003Cspan class=\"hljs-keyword\">with\u003C/span> \u003Cspan class=\"hljs-built_in\">open\u003C/span>(file_path, \u003Cspan class=\"hljs-string\">'rb'\u003C/span>) \u003Cspan class=\"hljs-keyword\">as\u003C/span> f:\n                \u003Cspan class=\"hljs-keyword\">return\u003C/span> hashlib.md5(f.read()).hexdigest()\n        \n        self.get_file_hash = get_file_hash\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">validate_files_parallel\u003C/span>(\u003Cspan class=\"hljs-params\">self, file_paths: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>]\u003C/span>) -> \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-type\">Dict\u003C/span>]:\n        \u003Cspan class=\"hljs-string\">"""Validate files using parallel processing"""\u003C/span>\n        cpu_count = mp.cpu_count()\n        chunk_size = \u003Cspan class=\"hljs-built_in\">max\u003C/span>(\u003Cspan class=\"hljs-number\">1\u003C/span>, \u003Cspan class=\"hljs-built_in\">len\u003C/span>(file_paths) // cpu_count)\n        \n        \u003Cspan class=\"hljs-keyword\">with\u003C/span> ProcessPoolExecutor(max_workers=cpu_count) \u003Cspan class=\"hljs-keyword\">as\u003C/span> executor:\n            \u003Cspan class=\"hljs-comment\"># Split files into chunks for parallel processing\u003C/span>\n            file_chunks = [file_paths[i:i + chunk_size] \n                          \u003Cspan class=\"hljs-keyword\">for\u003C/span> i \u003Cspan class=\"hljs-keyword\">in\u003C/span> \u003Cspan class=\"hljs-built_in\">range\u003C/span>(\u003Cspan class=\"hljs-number\">0\u003C/span>, \u003Cspan class=\"hljs-built_in\">len\u003C/span>(file_paths), chunk_size)]\n            \n            \u003Cspan class=\"hljs-comment\"># Submit validation tasks\u003C/span>\n            futures = [executor.submit(self.validate_chunk, chunk) \n                      \u003Cspan class=\"hljs-keyword\">for\u003C/span> chunk \u003Cspan class=\"hljs-keyword\">in\u003C/span> file_chunks]\n            \n            \u003Cspan class=\"hljs-comment\"># Collect results\u003C/span>\n            all_results = []\n            \u003Cspan class=\"hljs-keyword\">for\u003C/span> future \u003Cspan class=\"hljs-keyword\">in\u003C/span> futures:\n                all_results.extend(future.result())\n            \n            \u003Cspan class=\"hljs-keyword\">return\u003C/span> all_results\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">validate_chunk\u003C/span>(\u003Cspan class=\"hljs-params\">self, file_paths: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>]\u003C/span>) -> \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-type\">Dict\u003C/span>]:\n        \u003Cspan class=\"hljs-string\">"""Validate a chunk of files"""\u003C/span>\n        validator = ContentValidator(self.config)\n        results = []\n        \n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> file_path \u003Cspan class=\"hljs-keyword\">in\u003C/span> file_paths:\n            \u003Cspan class=\"hljs-comment\"># Check cache first\u003C/span>\n            file_hash = self.get_file_hash(file_path)\n            cache_key = \u003Cspan class=\"hljs-string\">f"\u003Cspan class=\"hljs-subst\">{file_path}\u003C/span>:\u003Cspan class=\"hljs-subst\">{file_hash}\u003C/span>"\u003C/span>\n            \n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> cache_key \u003Cspan class=\"hljs-keyword\">in\u003C/span> self.cache:\n                results.extend(self.cache[cache_key])\n                \u003Cspan class=\"hljs-keyword\">continue\u003C/span>\n            \n            \u003Cspan class=\"hljs-comment\"># Validate file\u003C/span>\n            file_results = validator.validate_file(file_path)\n            self.cache[cache_key] = file_results\n            results.extend(file_results)\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> results\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">validate_external_links_async\u003C/span>(\u003Cspan class=\"hljs-params\">self, links: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>]\u003C/span>) -> \u003Cspan class=\"hljs-type\">Dict\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>, \u003Cspan class=\"hljs-built_in\">bool\u003C/span>]:\n        \u003Cspan class=\"hljs-string\">"""Validate external links asynchronously"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> self.session:\n            timeout = aiohttp.ClientTimeout(total=\u003Cspan class=\"hljs-number\">10\u003C/span>)\n            self.session = aiohttp.ClientSession(timeout=timeout)\n        \n        \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">check_link\u003C/span>(\u003Cspan class=\"hljs-params\">session: aiohttp.ClientSession, url: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\u003C/span>) -> \u003Cspan class=\"hljs-built_in\">tuple\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>, \u003Cspan class=\"hljs-built_in\">bool\u003C/span>]:\n            \u003Cspan class=\"hljs-keyword\">try\u003C/span>:\n                \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-keyword\">with\u003C/span> session.head(url, allow_redirects=\u003Cspan class=\"hljs-literal\">True\u003C/span>) \u003Cspan class=\"hljs-keyword\">as\u003C/span> response:\n                    \u003Cspan class=\"hljs-keyword\">return\u003C/span> url, response.status < \u003Cspan class=\"hljs-number\">400\u003C/span>\n            \u003Cspan class=\"hljs-keyword\">except\u003C/span>:\n                \u003Cspan class=\"hljs-keyword\">return\u003C/span> url, \u003Cspan class=\"hljs-literal\">False\u003C/span>\n        \n        \u003Cspan class=\"hljs-comment\"># Batch process links\u003C/span>\n        tasks = [check_link(self.session, url) \u003Cspan class=\"hljs-keyword\">for\u003C/span> url \u003Cspan class=\"hljs-keyword\">in\u003C/span> links]\n        results = \u003Cspan class=\"hljs-keyword\">await\u003C/span> asyncio.gather(*tasks, return_exceptions=\u003Cspan class=\"hljs-literal\">True\u003C/span>)\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> {url: result \u003Cspan class=\"hljs-keyword\">for\u003C/span> url, result \u003Cspan class=\"hljs-keyword\">in\u003C/span> results \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> \u003Cspan class=\"hljs-built_in\">isinstance\u003C/span>(result, Exception)}\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">incremental_validation\u003C/span>(\u003Cspan class=\"hljs-params\">self, base_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, changed_files: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>] = \u003Cspan class=\"hljs-literal\">None\u003C/span>\u003C/span>) -> \u003Cspan class=\"hljs-type\">Dict\u003C/span>:\n        \u003Cspan class=\"hljs-string\">"""Run incremental validation on changed files only"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> changed_files \u003Cspan class=\"hljs-keyword\">is\u003C/span> \u003Cspan class=\"hljs-literal\">None\u003C/span>:\n            \u003Cspan class=\"hljs-comment\"># Get changed files from Git\u003C/span>\n            \u003Cspan class=\"hljs-keyword\">import\u003C/span> subprocess\n            result = subprocess.run([\u003Cspan class=\"hljs-string\">'git'\u003C/span>, \u003Cspan class=\"hljs-string\">'diff'\u003C/span>, \u003Cspan class=\"hljs-string\">'--name-only'\u003C/span>, \u003Cspan class=\"hljs-string\">'HEAD~1'\u003C/span>, \u003Cspan class=\"hljs-string\">'HEAD'\u003C/span>], \n                                 capture_output=\u003Cspan class=\"hljs-literal\">True\u003C/span>, text=\u003Cspan class=\"hljs-literal\">True\u003C/span>, cwd=base_path)\n            changed_files = result.stdout.strip().split(\u003Cspan class=\"hljs-string\">'\\n'\u003C/span>) \u003Cspan class=\"hljs-keyword\">if\u003C/span> result.stdout \u003Cspan class=\"hljs-keyword\">else\u003C/span> []\n            changed_files = [f \u003Cspan class=\"hljs-keyword\">for\u003C/span> f \u003Cspan class=\"hljs-keyword\">in\u003C/span> changed_files \u003Cspan class=\"hljs-keyword\">if\u003C/span> f.endswith(\u003Cspan class=\"hljs-string\">'.md'\u003C/span>)]\n        \n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> changed_files:\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span> {\u003Cspan class=\"hljs-string\">'message'\u003C/span>: \u003Cspan class=\"hljs-string\">'No markdown files changed'\u003C/span>, \u003Cspan class=\"hljs-string\">'results'\u003C/span>: []}\n        \n        \u003Cspan class=\"hljs-comment\"># Validate only changed files\u003C/span>\n        results = self.validate_files_parallel(changed_files)\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> {\n            \u003Cspan class=\"hljs-string\">'changed_files'\u003C/span>: changed_files,\n            \u003Cspan class=\"hljs-string\">'results'\u003C/span>: results,\n            \u003Cspan class=\"hljs-string\">'summary'\u003C/span>: self.generate_summary(results)\n        }\n    \n\u003Cspan class=\"hljs-meta\">    @lru_cache(\u003Cspan class=\"hljs-params\">maxsize=\u003Cspan class=\"hljs-number\">1000\u003C/span>\u003C/span>)\u003C/span>\n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">cached_rule_check\u003C/span>(\u003Cspan class=\"hljs-params\">self, rule_id: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, content_hash: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, rule_params: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\u003C/span>) -> \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-type\">Dict\u003C/span>]:\n        \u003Cspan class=\"hljs-string\">"""Cache expensive rule checks"""\u003C/span>\n        \u003Cspan class=\"hljs-comment\"># This would implement the actual rule logic\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">pass\u003C/span>\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">smart_link_checking\u003C/span>(\u003Cspan class=\"hljs-params\">self, links: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>]\u003C/span>) -> \u003Cspan class=\"hljs-type\">Dict\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>, \u003Cspan class=\"hljs-built_in\">bool\u003C/span>]:\n        \u003Cspan class=\"hljs-string\">"""Smart link checking with caching and batching"""\u003C/span>\n        \u003Cspan class=\"hljs-comment\"># Group links by domain for efficient checking\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">from\u003C/span> urllib.parse \u003Cspan class=\"hljs-keyword\">import\u003C/span> urlparse\n        domain_groups = {}\n        \n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> link \u003Cspan class=\"hljs-keyword\">in\u003C/span> links:\n            domain = urlparse(link).netloc\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> domain \u003Cspan class=\"hljs-keyword\">not\u003C/span> \u003Cspan class=\"hljs-keyword\">in\u003C/span> domain_groups:\n                domain_groups[domain] = []\n            domain_groups[domain].append(link)\n        \n        \u003Cspan class=\"hljs-comment\"># Check each domain group with appropriate delays\u003C/span>\n        results = {}\n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> domain, domain_links \u003Cspan class=\"hljs-keyword\">in\u003C/span> domain_groups.items():\n            domain_results = asyncio.run(\n                self.validate_external_links_async(domain_links)\n            )\n            results.update(domain_results)\n            \n            \u003Cspan class=\"hljs-comment\"># Add delay between domains to be respectful\u003C/span>\n            time.sleep(\u003Cspan class=\"hljs-number\">1\u003C/span>)\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> results\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">generate_summary\u003C/span>(\u003Cspan class=\"hljs-params\">self, results: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-type\">Dict\u003C/span>]\u003C/span>) -> \u003Cspan class=\"hljs-type\">Dict\u003C/span>:\n        \u003Cspan class=\"hljs-string\">"""Generate validation summary"""\u003C/span>\n        severity_counts = {\u003Cspan class=\"hljs-string\">'error'\u003C/span>: \u003Cspan class=\"hljs-number\">0\u003C/span>, \u003Cspan class=\"hljs-string\">'warning'\u003C/span>: \u003Cspan class=\"hljs-number\">0\u003C/span>, \u003Cspan class=\"hljs-string\">'info'\u003C/span>: \u003Cspan class=\"hljs-number\">0\u003C/span>}\n        rule_counts = {}\n        \n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> result \u003Cspan class=\"hljs-keyword\">in\u003C/span> results:\n            severity_counts[result.get(\u003Cspan class=\"hljs-string\">'severity'\u003C/span>, \u003Cspan class=\"hljs-string\">'info'\u003C/span>)] += \u003Cspan class=\"hljs-number\">1\u003C/span>\n            rule_id = result.get(\u003Cspan class=\"hljs-string\">'rule_id'\u003C/span>, \u003Cspan class=\"hljs-string\">'unknown'\u003C/span>)\n            rule_counts[rule_id] = rule_counts.get(rule_id, \u003Cspan class=\"hljs-number\">0\u003C/span>) + \u003Cspan class=\"hljs-number\">1\u003C/span>\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> {\n            \u003Cspan class=\"hljs-string\">'total_issues'\u003C/span>: \u003Cspan class=\"hljs-built_in\">len\u003C/span>(results),\n            \u003Cspan class=\"hljs-string\">'by_severity'\u003C/span>: severity_counts,\n            \u003Cspan class=\"hljs-string\">'top_rules'\u003C/span>: \u003Cspan class=\"hljs-built_in\">sorted\u003C/span>(rule_counts.items(), key=\u003Cspan class=\"hljs-keyword\">lambda\u003C/span> x: x[\u003Cspan class=\"hljs-number\">1\u003C/span>], reverse=\u003Cspan class=\"hljs-literal\">True\u003C/span>)[:\u003Cspan class=\"hljs-number\">5\u003C/span>],\n            \u003Cspan class=\"hljs-string\">'validation_time'\u003C/span>: time.time()\n        }\n\n\u003Cspan class=\"hljs-comment\"># Usage example\u003C/span>\n\u003Cspan class=\"hljs-keyword\">if\u003C/span> __name__ == \u003Cspan class=\"hljs-string\">"__main__"\u003C/span>:\n    config = {\u003Cspan class=\"hljs-string\">'rules'\u003C/span>: {\u003Cspan class=\"hljs-string\">'links'\u003C/span>: {\u003Cspan class=\"hljs-string\">'enabled'\u003C/span>: \u003Cspan class=\"hljs-literal\">True\u003C/span>}}}  \u003Cspan class=\"hljs-comment\"># Simplified config\u003C/span>\n    \n    optimizer = OptimizedValidator(config)\n    optimizer.setup_caching()\n    \n    \u003Cspan class=\"hljs-comment\"># Run incremental validation\u003C/span>\n    results = optimizer.incremental_validation(\u003Cspan class=\"hljs-string\">'.'\u003C/span>)\n    \u003Cspan class=\"hljs-built_in\">print\u003C/span>(json.dumps(results, indent=\u003Cspan class=\"hljs-number\">2\u003C/span>))\n\u003C/code>\u003C/pre>\u003Ch3 id=\"false-positive-management\">False Positive Management\u003C/h3>\n\u003Cp>\u003Cstrong>Problem\u003C/strong>: Validation rules generating too many false positives\u003C/p>\n\u003Cp>\u003Cstrong>Solutions\u003C/strong>:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-python\">\u003Cspan class=\"hljs-comment\"># false_positive_manager.py - Manage and reduce false positives\u003C/span>\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> re\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> yaml\n\u003Cspan class=\"hljs-keyword\">from\u003C/span> typing \u003Cspan class=\"hljs-keyword\">import\u003C/span> \u003Cspan class=\"hljs-type\">Dict\u003C/span>, \u003Cspan class=\"hljs-type\">List\u003C/span>, \u003Cspan class=\"hljs-type\">Set\u003C/span>, \u003Cspan class=\"hljs-type\">Optional\u003C/span>\n\u003Cspan class=\"hljs-keyword\">from\u003C/span> dataclasses \u003Cspan class=\"hljs-keyword\">import\u003C/span> dataclass\n\n\u003Cspan class=\"hljs-meta\">@dataclass\u003C/span>\n\u003Cspan class=\"hljs-keyword\">class\u003C/span> \u003Cspan class=\"hljs-title class_\">Suppression\u003C/span>:\n    rule_id: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\n    file_pattern: \u003Cspan class=\"hljs-type\">Optional\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>] = \u003Cspan class=\"hljs-literal\">None\u003C/span>\n    line_pattern: \u003Cspan class=\"hljs-type\">Optional\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>] = \u003Cspan class=\"hljs-literal\">None\u003C/span>\n    reason: \u003Cspan class=\"hljs-built_in\">str\u003C/span> = \u003Cspan class=\"hljs-string\">""\u003C/span>\n    expires: \u003Cspan class=\"hljs-type\">Optional\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>] = \u003Cspan class=\"hljs-literal\">None\u003C/span>\n\n\u003Cspan class=\"hljs-keyword\">class\u003C/span> \u003Cspan class=\"hljs-title class_\">FalsePositiveManager\u003C/span>:\n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">__init__\u003C/span>(\u003Cspan class=\"hljs-params\">self, suppressions_file: \u003Cspan class=\"hljs-built_in\">str\u003C/span> = \u003Cspan class=\"hljs-string\">"validation_suppressions.yaml"\u003C/span>\u003C/span>):\n        self.suppressions = self.load_suppressions(suppressions_file)\n        self.whitelist_patterns = self.load_whitelist_patterns()\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">load_suppressions\u003C/span>(\u003Cspan class=\"hljs-params\">self, file_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\u003C/span>) -> \u003Cspan class=\"hljs-type\">List\u003C/span>[Suppression]:\n        \u003Cspan class=\"hljs-string\">"""Load validation suppressions from YAML file"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">try\u003C/span>:\n            \u003Cspan class=\"hljs-keyword\">with\u003C/span> \u003Cspan class=\"hljs-built_in\">open\u003C/span>(file_path, \u003Cspan class=\"hljs-string\">'r'\u003C/span>) \u003Cspan class=\"hljs-keyword\">as\u003C/span> f:\n                data = yaml.safe_load(f)\n                \u003Cspan class=\"hljs-keyword\">return\u003C/span> [Suppression(**item) \u003Cspan class=\"hljs-keyword\">for\u003C/span> item \u003Cspan class=\"hljs-keyword\">in\u003C/span> data.get(\u003Cspan class=\"hljs-string\">'suppressions'\u003C/span>, [])]\n        \u003Cspan class=\"hljs-keyword\">except\u003C/span> FileNotFoundError:\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span> []\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">load_whitelist_patterns\u003C/span>(\u003Cspan class=\"hljs-params\">self\u003C/span>) -> \u003Cspan class=\"hljs-type\">Dict\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>, \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>]]:\n        \u003Cspan class=\"hljs-string\">"""Load rule-specific whitelist patterns"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> {\n            \u003Cspan class=\"hljs-string\">'link_broken_external'\u003C/span>: [\n                \u003Cspan class=\"hljs-string\">r'https://example\\.com.*'\u003C/span>,  \u003Cspan class=\"hljs-comment\"># Example URLs\u003C/span>\n                \u003Cspan class=\"hljs-string\">r'https://placeholder\\..*'\u003C/span>,  \u003Cspan class=\"hljs-comment\"># Placeholder URLs\u003C/span>\n                \u003Cspan class=\"hljs-string\">r'https://.*\\.localhost.*'\u003C/span>,  \u003Cspan class=\"hljs-comment\"># Local development URLs\u003C/span>\n            ],\n            \u003Cspan class=\"hljs-string\">'image_missing_alt'\u003C/span>: [\n                \u003Cspan class=\"hljs-string\">r'!\\[.*\\]\\(.*spacer\\.gif\\)'\u003C/span>,  \u003Cspan class=\"hljs-comment\"># Spacer images\u003C/span>\n                \u003Cspan class=\"hljs-string\">r'!\\[.*\\]\\(.*pixel\\.png\\)'\u003C/span>,  \u003Cspan class=\"hljs-comment\"># Tracking pixels\u003C/span>\n            ],\n            \u003Cspan class=\"hljs-string\">'heading_generic'\u003C/span>: [\n                \u003Cspan class=\"hljs-string\">r'^(Overview|Introduction|Getting Started)$'\u003C/span>,  \u003Cspan class=\"hljs-comment\"># Allow common generic headings\u003C/span>\n            ]\n        }\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">should_suppress\u003C/span>(\u003Cspan class=\"hljs-params\">self, result: \u003Cspan class=\"hljs-type\">Dict\u003C/span>, file_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, line_content: \u003Cspan class=\"hljs-built_in\">str\u003C/span>\u003C/span>) -> \u003Cspan class=\"hljs-built_in\">bool\u003C/span>:\n        \u003Cspan class=\"hljs-string\">"""Check if a validation result should be suppressed"""\u003C/span>\n        rule_id = result.get(\u003Cspan class=\"hljs-string\">'rule_id'\u003C/span>)\n        \n        \u003Cspan class=\"hljs-comment\"># Check suppressions\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> suppression \u003Cspan class=\"hljs-keyword\">in\u003C/span> self.suppressions:\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> suppression.rule_id != rule_id:\n                \u003Cspan class=\"hljs-keyword\">continue\u003C/span>\n            \n            \u003Cspan class=\"hljs-comment\"># Check file pattern\u003C/span>\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> suppression.file_pattern:\n                \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> re.search(suppression.file_pattern, file_path):\n                    \u003Cspan class=\"hljs-keyword\">continue\u003C/span>\n            \n            \u003Cspan class=\"hljs-comment\"># Check line pattern\u003C/span>\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> suppression.line_pattern:\n                \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> re.search(suppression.line_pattern, line_content):\n                    \u003Cspan class=\"hljs-keyword\">continue\u003C/span>\n            \n            \u003Cspan class=\"hljs-comment\"># Check expiration\u003C/span>\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> suppression.expires:\n                \u003Cspan class=\"hljs-keyword\">from\u003C/span> datetime \u003Cspan class=\"hljs-keyword\">import\u003C/span> datetime\n                expire_date = datetime.fromisoformat(suppression.expires)\n                \u003Cspan class=\"hljs-keyword\">if\u003C/span> datetime.now() > expire_date:\n                    \u003Cspan class=\"hljs-keyword\">continue\u003C/span>\n            \n            \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-literal\">True\u003C/span>\n        \n        \u003Cspan class=\"hljs-comment\"># Check whitelist patterns\u003C/span>\n        patterns = self.whitelist_patterns.get(rule_id, [])\n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> pattern \u003Cspan class=\"hljs-keyword\">in\u003C/span> patterns:\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> re.search(pattern, result.get(\u003Cspan class=\"hljs-string\">'context'\u003C/span>, \u003Cspan class=\"hljs-string\">''\u003C/span>) \u003Cspan class=\"hljs-keyword\">or\u003C/span> line_content):\n                \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-literal\">True\u003C/span>\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-literal\">False\u003C/span>\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">create_smart_suppressions\u003C/span>(\u003Cspan class=\"hljs-params\">self, results: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-type\">Dict\u003C/span>], threshold: \u003Cspan class=\"hljs-built_in\">int\u003C/span> = \u003Cspan class=\"hljs-number\">5\u003C/span>\u003C/span>) -> \u003Cspan class=\"hljs-type\">List\u003C/span>[Suppression]:\n        \u003Cspan class=\"hljs-string\">"""Automatically suggest suppressions for frequently occurring issues"""\u003C/span>\n        \u003Cspan class=\"hljs-comment\"># Count rule occurrences\u003C/span>\n        rule_counts = {}\n        rule_contexts = {}\n        \n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> result \u003Cspan class=\"hljs-keyword\">in\u003C/span> results:\n            rule_id = result.get(\u003Cspan class=\"hljs-string\">'rule_id'\u003C/span>)\n            context = result.get(\u003Cspan class=\"hljs-string\">'context'\u003C/span>, \u003Cspan class=\"hljs-string\">''\u003C/span>)\n            \n            rule_counts[rule_id] = rule_counts.get(rule_id, \u003Cspan class=\"hljs-number\">0\u003C/span>) + \u003Cspan class=\"hljs-number\">1\u003C/span>\n            \n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> rule_id \u003Cspan class=\"hljs-keyword\">not\u003C/span> \u003Cspan class=\"hljs-keyword\">in\u003C/span> rule_contexts:\n                rule_contexts[rule_id] = []\n            rule_contexts[rule_id].append(context)\n        \n        \u003Cspan class=\"hljs-comment\"># Suggest suppressions for high-frequency rules\u003C/span>\n        suggestions = []\n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> rule_id, count \u003Cspan class=\"hljs-keyword\">in\u003C/span> rule_counts.items():\n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> count >= threshold:\n                \u003Cspan class=\"hljs-comment\"># Analyze contexts to find common patterns\u003C/span>\n                contexts = rule_contexts[rule_id]\n                common_pattern = self.find_common_pattern(contexts)\n                \n                \u003Cspan class=\"hljs-keyword\">if\u003C/span> common_pattern:\n                    suggestions.append(Suppression(\n                        rule_id=rule_id,\n                        line_pattern=common_pattern,\n                        reason=\u003Cspan class=\"hljs-string\">f"Auto-suggested: \u003Cspan class=\"hljs-subst\">{count}\u003C/span> occurrences with common pattern"\u003C/span>\n                    ))\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> suggestions\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">find_common_pattern\u003C/span>(\u003Cspan class=\"hljs-params\">self, contexts: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>]\u003C/span>) -> \u003Cspan class=\"hljs-type\">Optional\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>]:\n        \u003Cspan class=\"hljs-string\">"""Find common pattern in validation contexts"""\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-built_in\">len\u003C/span>(contexts) < \u003Cspan class=\"hljs-number\">2\u003C/span>:\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-literal\">None\u003C/span>\n        \n        \u003Cspan class=\"hljs-comment\"># Simple pattern detection - find common prefixes/suffixes\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-built_in\">len\u003C/span>(\u003Cspan class=\"hljs-built_in\">set\u003C/span>(contexts)) == \u003Cspan class=\"hljs-number\">1\u003C/span>:\n            \u003Cspan class=\"hljs-comment\"># All contexts are identical\u003C/span>\n            \u003Cspan class=\"hljs-keyword\">return\u003C/span> re.escape(contexts[\u003Cspan class=\"hljs-number\">0\u003C/span>])\n        \n        \u003Cspan class=\"hljs-comment\"># Check for common URL patterns\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-built_in\">all\u003C/span>(\u003Cspan class=\"hljs-string\">'http'\u003C/span> \u003Cspan class=\"hljs-keyword\">in\u003C/span> ctx \u003Cspan class=\"hljs-keyword\">for\u003C/span> ctx \u003Cspan class=\"hljs-keyword\">in\u003C/span> contexts):\n            domains = [re.findall(\u003Cspan class=\"hljs-string\">r'https?://([^/]+)'\u003C/span>, ctx) \u003Cspan class=\"hljs-keyword\">for\u003C/span> ctx \u003Cspan class=\"hljs-keyword\">in\u003C/span> contexts]\n            common_domains = \u003Cspan class=\"hljs-built_in\">set\u003C/span>(domains[\u003Cspan class=\"hljs-number\">0\u003C/span>])\n            \u003Cspan class=\"hljs-keyword\">for\u003C/span> domain_list \u003Cspan class=\"hljs-keyword\">in\u003C/span> domains[\u003Cspan class=\"hljs-number\">1\u003C/span>:]:\n                common_domains &= \u003Cspan class=\"hljs-built_in\">set\u003C/span>(domain_list)\n            \n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> common_domains:\n                domain = \u003Cspan class=\"hljs-built_in\">list\u003C/span>(common_domains)[\u003Cspan class=\"hljs-number\">0\u003C/span>]\n                \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-string\">f'https?://\u003Cspan class=\"hljs-subst\">{re.escape(domain)}\u003C/span>.*'\u003C/span>\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-literal\">None\u003C/span>\n    \n    \u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">filter_results\u003C/span>(\u003Cspan class=\"hljs-params\">self, results: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-type\">Dict\u003C/span>], file_path: \u003Cspan class=\"hljs-built_in\">str\u003C/span>, file_lines: \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-built_in\">str\u003C/span>]\u003C/span>) -> \u003Cspan class=\"hljs-type\">List\u003C/span>[\u003Cspan class=\"hljs-type\">Dict\u003C/span>]:\n        \u003Cspan class=\"hljs-string\">"""Filter validation results to remove suppressed issues"""\u003C/span>\n        filtered_results = []\n        \n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> result \u003Cspan class=\"hljs-keyword\">in\u003C/span> results:\n            line_num = result.get(\u003Cspan class=\"hljs-string\">'line_number'\u003C/span>, \u003Cspan class=\"hljs-number\">0\u003C/span>)\n            line_content = file_lines[line_num - \u003Cspan class=\"hljs-number\">1\u003C/span>] \u003Cspan class=\"hljs-keyword\">if\u003C/span> line_num > \u003Cspan class=\"hljs-number\">0\u003C/span> \u003Cspan class=\"hljs-keyword\">and\u003C/span> line_num <= \u003Cspan class=\"hljs-built_in\">len\u003C/span>(file_lines) \u003Cspan class=\"hljs-keyword\">else\u003C/span> \u003Cspan class=\"hljs-string\">""\u003C/span>\n            \n            \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> self.should_suppress(result, file_path, line_content):\n                filtered_results.append(result)\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> filtered_results\n\u003C/code>\u003C/pre>\u003Ch2 id=\"conclusion\">Conclusion\u003C/h2>\n\u003Cp>Automated Markdown content validation and quality assurance systems provide the foundation for maintaining professional documentation standards while enabling teams to scale their content creation processes efficiently. By implementing comprehensive validation frameworks, establishing quality metrics dashboards, and integrating automated checks into development workflows, organizations can ensure consistent, accessible, and high-quality documentation that serves users effectively while reducing manual oversight burden.\u003C/p>\n\u003Cp>The key to successful validation implementation lies in balancing comprehensive coverage with practical usability, ensuring that validation rules enhance rather than hinder the content creation process. Whether you're building internal documentation systems, open-source project documentation, or comprehensive knowledge bases, the techniques covered in this guide provide the tools necessary for creating robust, automated quality assurance systems that support both content creators and content consumers.\u003C/p>\n\u003Cp>Remember to continuously refine your validation rules based on team feedback and real-world usage patterns, implement performance optimizations for large repositories, and maintain clear documentation of validation standards to enable effective collaboration. With proper implementation of automated content validation, your documentation can achieve and maintain professional standards while supporting rapid content development and team scalability.\u003C/p>\n",[15,19,22,25,28,31,34],{"id":16,"text":17,"level":18},"why-master-automated-content-validation","Why Master Automated Content Validation?",2,{"id":20,"text":21,"level":18},"foundation-validation-systems","Foundation Validation Systems",{"id":23,"text":24,"level":18},"cicd-integration-and-automation","CI/CD Integration and Automation",{"id":26,"text":27,"level":18},"integration-with-content-management","Integration with Content Management",{"id":29,"text":30,"level":18},"advanced-quality-metrics-and-reporting","Advanced Quality Metrics and Reporting",{"id":32,"text":33,"level":18},"troubleshooting-common-validation-issues","Troubleshooting Common Validation Issues",{"id":35,"text":36,"level":18},"conclusion","Conclusion",[],[39,46,54],{"slug":40,"title":41,"description":42,"excerpt":43,"date":44,"category":9,"author":10,"keywords":45,"readingMinutes":12},"markdown-content-validation-automated-quality-assurance-complete-guide","Markdown Content Validation and Automated Quality Assurance: Complete Guide for Robust Documentation Workflows","Master comprehensive Markdown content validation techniques including syntax checking, link verification, accessibility testing, and automated quality assurance systems. Learn to build reliable documentation workflows with error prevention and content integrity checks.","Advanced Markdown content validation and automated quality assurance systems ensure documentation integrity, prevent content errors, and maintain consistent formatting standards across large-scale…","2025-10-09","markdown validation, markdown quality assurance, markdown syntax checking, link validation markdown, markdown testing automation, content validation tools, markdown linting, documentation qa",{"slug":47,"title":48,"description":49,"excerpt":50,"date":51,"category":9,"author":10,"keywords":52,"readingMinutes":53},"markdown-error-handling-validation-complete-guide","Markdown Error Handling and Validation: Complete Guide for Content Quality Assurance and Automated Checking","Master Markdown error handling, validation techniques, and automated quality assurance. Learn syntax checking, link validation, content linting, and comprehensive testing strategies for robust Markdown workflows.","Markdown error handling and validation techniques enable content teams to maintain high-quality documentation through automated quality assurance processes that catch syntax errors, validate…","2025-12-04","markdown validation, markdown error handling, markdown linting, content quality assurance, markdown syntax checking, automated markdown testing, markdown workflow validation",28,{"slug":55,"title":56,"description":57,"excerpt":58,"date":59,"category":9,"author":10,"keywords":60,"readingMinutes":61},"markdown-table-data-validation-quality-assurance-complete-guide","Markdown Table Data Validation and Quality Assurance: Complete Guide for Automated Table Content Verification","Master comprehensive table data validation techniques in Markdown for automated quality assurance, content verification, and structural integrity checking. Learn advanced validation patterns and automated testing workflows.","Markdown table data validation and quality assurance ensure accurate, consistent, and reliable table content across documentation systems through automated verification, structural integrity…","2025-11-09","markdown table validation, data quality assurance, table content verification, automated markdown testing, table structure validation, data integrity checking, markdown quality control, table validation tools",22,1792184943087]