fix doc errors

soodoku · soodoku · commit cd57373dcd98 · 2025-12-11T15:36:59.000-08:00
diff --git a/docs/source/_static/.gitkeep b/docs/source/_static/.gitkeep
@@ -0,0 +1 @@
+# Keep this directory in git
diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -32,7 +32,7 @@
 ]
 
 templates_path = ["_templates"]
-exclude_patterns = []
+exclude_patterns = ["_snippets/"]
 
 # -- Options for HTML output ------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
@@ -57,6 +57,7 @@
     "smartquotes",
     "tasklist",
 ]
+myst_heading_anchors = 2  # Allow documents to start with H2
 source_suffix = {
     ".rst": "restructuredtext",
     ".md": "markdown",

Original file line number	Diff line number	Diff line change
`@@ -32,7 +32,7 @@`
`32`	`32`	`]`
`33`	`33`
`34`	`34`	`templates_path = ["_templates"]`
`35`		`-exclude_patterns = []`
	`35`	`+exclude_patterns = ["_snippets/"]`
`36`	`36`
`37`	`37`	`# -- Options for HTML output ------------------------------------------------`
`38`	`38`	`# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output`
`@@ -57,6 +57,7 @@`
`57`	`57`	`"smartquotes",`
`58`	`58`	`"tasklist",`
`59`	`59`	`]`
	`60`	`+myst_heading_anchors = 2 # Allow documents to start with H2`
`60`	`61`	`source_suffix = {`
`61`	`62`	`".rst": "restructuredtext",`
`62`	`63`	`".md": "markdown",`