From 5add60207f20e2339920740c6481399b394185da Mon Sep 17 00:00:00 2001 From: Richard Abrich Date: Sat, 17 Jan 2026 00:49:22 -0500 Subject: [PATCH] fix: Resolve MkDocs build failures in strict mode - Create missing docs/design/INDEX.md referenced in mkdocs.yml nav - Fix nested code fences in landing-page-strategy.md causing sections 6 and 7 to be rendered inside code blocks instead of as proper headings The nested ```bash block inside section 5.5's outer ``` block was causing parsing issues. Using 4 backticks for the outer block allows proper nesting. Co-Authored-By: Claude Sonnet 4.5 --- docs/design/INDEX.md | 11 +++++++++++ docs/design/landing-page-strategy.md | 4 ++-- 2 files changed, 13 insertions(+), 2 deletions(-) create mode 100644 docs/design/INDEX.md diff --git a/docs/design/INDEX.md b/docs/design/INDEX.md new file mode 100644 index 000000000..e8d53db5c --- /dev/null +++ b/docs/design/INDEX.md @@ -0,0 +1,11 @@ +# Design Documents + +This section contains design documents and specifications for OpenAdapt features and components. + +## Documents + +- [System Tray App](openadapt-tray.md) - Design specification for the OpenAdapt system tray application +- [Tray Logging](tray-logging.md) - Logging architecture for the tray application +- [Telemetry](telemetry-design.md) - Telemetry and analytics design +- [Landing Page Strategy](landing-page-strategy.md) - Website landing page strategy and messaging +- [Repo Rename Analysis](repo-rename-analysis.md) - Analysis for repository renaming considerations diff --git a/docs/design/landing-page-strategy.md b/docs/design/landing-page-strategy.md index ca6e31556..3c9ccf438 100644 --- a/docs/design/landing-page-strategy.md +++ b/docs/design/landing-page-strategy.md @@ -371,7 +371,7 @@ No vendor lock-in, ever. ### 5.5 For Developers Section -``` +```` ## Built for Developers ### Modular Architecture @@ -404,7 +404,7 @@ Integrated with Windows Agent Arena (WAA), WebArena, and OSWorld. Compare your models against published baselines. [View Documentation] [GitHub Repository] -``` +```` ### 5.6 For Enterprise Section