[clang] [analyzer][docs] Fix invalid MyST toctree 'numbered' option after Markdown migration (PR #207217)

[via cfe-commits]

llvmorg-github-actions[bot] wrote:


<!--LLVM PR SUMMARY COMMENT-->

@llvm/pr-subscribers-clang-static-analyzer-1

Author: Balázs Benics (steakhal)

<details>
<summary>Changes</summary>

The RST-to-Markdown migration (#<!-- -->206181) converted the RST flag `:numbered:` into `:numbered: true`.

MyST parses the toctree `numbered` option as `int_or_nothing`, so the string `true` fails with:

```
'toctree': Invalid option value for 'numbered': true:
invalid literal for int() with base 10: 'true'
```

This breaks the `-W` (warnings-as-errors) `docs-clang-html` build.
Make `numbered` a valueless flag, which MyST accepts (equivalent to the original RST behavior of numbering all levels).

Assisted-By: claude

---
Full diff: https://github.com/llvm/llvm-project/pull/207217.diff


2 Files Affected:

- (modified) clang/docs/ClangStaticAnalyzer.md (+1-1) 
- (modified) clang/docs/ScalableStaticAnalysis/index.md (+1-1) 


``````````diff
diff --git a/clang/docs/ClangStaticAnalyzer.md b/clang/docs/ClangStaticAnalyzer.md
index 0172c6f4a5e9d..edb76249a9f8a 100644
--- a/clang/docs/ClangStaticAnalyzer.md
+++ b/clang/docs/ClangStaticAnalyzer.md
@@ -10,7 +10,7 @@ This is the documentation page of the Static Analyzer; there is also an old [Off
 ```{toctree}
 :caption: Table of Contents
 :maxdepth: 2
-:numbered: true
+:numbered:
 
 analyzer/checkers
 analyzer/user-docs
diff --git a/clang/docs/ScalableStaticAnalysis/index.md b/clang/docs/ScalableStaticAnalysis/index.md
index 841fbb1bd3bc5..37cebb69d06a2 100644
--- a/clang/docs/ScalableStaticAnalysis/index.md
+++ b/clang/docs/ScalableStaticAnalysis/index.md
@@ -5,7 +5,7 @@ This is a framework for writing cross-translation unit analyses in a scalable an
 ```{toctree}
 :glob: true
 :maxdepth: 2
-:numbered: true
+:numbered:
 
 user-docs/*
 ```

``````````

</details>


https://github.com/llvm/llvm-project/pull/207217