[AAASM-3549] 🐛 (docs): Restore mkdocs search plugin#166
Conversation
The explicit `plugins:` list in mkdocs.yml only declared `mkdocstrings` and `mike`. Declaring any plugin disables MkDocs' implicit defaults, so the built-in `search` plugin was no longer loaded and the rendered site lost its search bar (no search index emitted). Add `- search` as the first plugin entry to restore the search bar and the generated search index. Verified with `mkdocs build --strict`: clean build (only the pre-existing release/RUNBOOK.md not-in-nav INFO) and `site/search/search_index.json` is regenerated. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
Claude Code — review result ✅ CI green — Scope vs AAASM-3549 — fully covered. The Python SDK docs had lost their search bar because Ready for approval + merge. Minimal, correct fix matching the ticket exactly. |
Description
The MkDocs site lost its search bar because
mkdocs.yml's explicitplugins:list omitted the built-insearchplugin. Declaring any plugin disables MkDocs' implicit defaults, so with onlymkdocstringsandmikelisted,searchwas no longer loaded and no search index was emitted.This PR adds
- searchas the first entry underplugins:, restoring the search bar and the generated search index. Only that one entry changed — nothing else inmkdocs.ymlwas touched.Type of Change
Breaking Changes
Related Issues
Testing
Describe the testing performed for this PR:
uv run --group docs mkdocs build --strictbuilds cleanly (the only non-fatal note is the pre-existingrelease/RUNBOOK.mdnot-in-nav INFO). The search index is regenerated atsite/search/search_index.json(~270 KB), confirming thesearchplugin is loaded again.Checklist