[nvbugs/6784181][fix] Stop test_relative_path_validity flagging generated docs and installed envs

test_relative_path_validity resolved every relative markdown link against the
worktree, which produced two classes of false positive:

- Links to Sphinx pages that docs/source/helper.py generates at build time
  (llm_api_examples, trtllm_serve_examples, visual_gen_examples). These are
  gitignored, so they can never exist in a source checkout even though
  docs/source/index.rst references them from a real toctree. Add an explicit
  allowlist keyed off helper.py's write_index() outputs.

- Third-party markdown vendored inside an installed Python environment under
  the repository root. Pruning only matched directories named .venv/venv, so an
  environment under any other name was walked and its READMEs validated against
  this repository. Detect environments by their pyvenv.cfg marker and
  site-packages layout, and skip .dist-info/.egg-info metadata directories.

Genuinely broken relative links are still reported. Removes the waiver for this
failure.

Signed-off-by: trtllm-agent <296075020+trtllm-agent@users.noreply.github.com>

Author: trtllm-agent

tests/integration/defs/test_doc.py

@@ -38,6 +38,16 @@
     "ATTRIBUTIONS-CPP-aarch64.md",
 }
 
+# Sphinx pages that docs/source/helper.py generates at build time via its
+# write_index() calls. They are gitignored (see .gitignore "docs/source/**/*.rst"),
+# so a link to one is correct even though it resolves to nothing in a source
+# checkout. Paths are repository-relative.
+SPHINX_GENERATED_DOC_PAGES = {
+    "docs/source/examples/llm_api_examples.rst",
+    "docs/source/examples/trtllm_serve_examples.rst",
+    "docs/source/examples/visual_gen_examples.rst",
+}
+
 # URLs that return 404 at HTTP level but are valid in a browser
 # (e.g., GitHub Pages sites using JS redirects)
 EXCEPTION_URLS = [
@@ -149,6 +159,13 @@ def _clean_markdown_destination(destination):
 def _find_markdown_files(root_dir):
     markdown_files = []
     for dirpath, dirnames, filenames in os.walk(root_dir):
+        # Installed Python environments vendor third-party markdown whose relative
+        # links describe the upstream source tree, not this repository. Detect them
+        # by layout rather than by name, since SKIP_DIR_PREFIXES misses an
+        # environment created under an arbitrary name (e.g. a CI scratch dir).
+        if "pyvenv.cfg" in filenames or "site-packages" in dirnames:
+            dirnames[:] = []
+            continue
         # Prune in-place so os.walk doesn't descend into skipped dirs.
         dirnames[:] = [
             d for d in dirnames if d not in SKIP_DIR_NAMES and not d.startswith(SKIP_DIR_PREFIXES)
@@ -223,6 +240,12 @@ def _check_relative_repository_link(url_info, source_file, root_dir):
     candidate_paths = [local_path]
     if not os.path.splitext(local_path)[1]:
         candidate_paths.extend((f"{local_path}.md", f"{local_path}.rst"))
+
+    for candidate_path in candidate_paths:
+        relative_path = os.path.relpath(candidate_path, root_dir)
+        if relative_path in SPHINX_GENERATED_DOC_PAGES:
+            return True, url, line_num, f"Sphinx-generated page: {relative_path}"
+
     is_valid = any(os.path.exists(candidate_path) for candidate_path in candidate_paths)
     reason = f"Repository path {'exists' if is_valid else 'not found'}: {local_path}"
     return is_valid, url, line_num, reason

tests/integration/test_lists/waives.txt

@@ -230,7 +230,6 @@ full:RTX_PRO_6000_Blackwell_Server_Edition/accuracy/test_llm_api_pytorch.py::Tes
 full:RTX_PRO_6000_Blackwell_Server_Edition/accuracy/test_llm_api_pytorch.py::TestGPTOSS::test_w4_2gpus[dp2-cutlass-auto] SKIP (https://nvbugs/6844164)
 full:sm100/unittest/bindings SKIP (Disable for Blackwell)
 perf/test_visual_gen_perf_sanity.py::test_visual_gen_e2e[vg_upload-flux2_blackwell-flux2_fp8_cfg1_ulysses4_teacache_on] SKIP (https://nvbugs/6759009)
-test_doc.py::test_relative_path_validity SKIP (https://nvbugs/6784181)
 test_e2e.py::test_openai_disagg_multi_nodes_completion[ctx_tp1pp2-gen_tp1pp2] SKIP (https://nvbugs/6812588)
 test_e2e.py::test_ptp_quickstart_advanced[Nemotron-Nano-9B-v2-nvfp4-NVIDIA-Nemotron-Nano-9B-v2-NVFP4] SKIP (https://nvbugs/6624972)
 test_e2e.py::test_ptp_quickstart_bert[TRTLLM-BertForSequenceClassification-bert/bert-base-uncased-yelp-polarity] SKIP (https://nvbugs/6605819)