[PavanaSakethaRam]

What This PR Does

Adds "docs" to ROOTS in cuda-oxide/scripts/check-source-references.sh so broken prose references to files under the repository's docs/ directory (docs/build_all_docs.sh, docs/conf.py, docs/index.md) are caught by CI instead of silently ignored.

BEFORE:
  ROOTS = ("cuda-oxide/crates", "cuda-oxide/cuda-oxide-book", "cuda-oxide/scripts")
  prose reference to `docs/missing.md` ──► ignored (silent PASS)

AFTER:
  ROOTS = ("cuda-oxide/crates", "cuda-oxide/cuda-oxide-book", "cuda-oxide/scripts", "docs")
  prose reference to `docs/missing.md` ──► rejected by check-source-references.sh

• Adds 10 embedded self-test controls covering missing docs/ files, untracked docs/ files, Markdown links, Rust doc comments, path traversal (docs/../README.md), external URLs, and declared generated outputs.

---

Verification

• bash cuda-oxide/scripts/check-source-references.sh: PASS (96 repository-anchored paths checked, plus all embedded self-test controls).

Closes #1248

[copy-pr-bot]

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

[nihalpasham]

Thanks for extending check-source-references.sh to cover the root docs/ tree and adding the self-test controls.

Verified bash cuda-oxide/scripts/check-source-references.sh (96 repo-anchored paths checked) and all repository guards at cc85052e. Merging once CI is green.

[nihalpasham]

/ok to test 365e79d