fix: improve link checking in documentation by excluding code blocks

- Enhance the `check_relative_links` function in `check_docs.py` to remove code blocks from markdown files before checking for relative links. This change prevents false positives from links within code examples, improving the accuracy of link validation.

These updates aim to enhance the reliability of documentation checks and ensure that only relevant links are evaluated.

Author: raychrisgdp

scripts/check_docs.py

@@ -31,7 +31,12 @@ def check_relative_links(markdown_files: list[Path]) -> list[str]:
 
     for md in markdown_files:
         text = md.read_text(encoding="utf-8")
-        for raw_target in LINK_RE.findall(text):
+
+        # Remove code blocks to avoid false positives from code examples
+        code_block_pattern = re.compile(r"```[\s\S]*?```", re.MULTILINE)
+        text_without_code = code_block_pattern.sub("", text)
+
+        for raw_target in LINK_RE.findall(text_without_code):
             target = raw_target.strip()
             if not target or target.startswith("#"):
                 continue