feat: Auto generate llms.txt + fix mermaid issue (#84)

PR#77 reverted the original implementation of llms.txt because it broke mermaid diagram rendering; this restores the original LLM changes + fixes the mermaid rendering issue by including it as extra-javascript.

I also removed a duplicate requirement of mkdocs-macros-plugin

Co-authored-by: Mackenzie Zastrow <zastrowm@users.noreply.github.com>

Author: zastrowm

mkdocs.yml

@@ -1,6 +1,7 @@
 site_name: Strands Agents SDK
 site_description: Documentation for Strands Agents, a simple-to-use, code-first, lightweight library for building AI agents
 site_dir: site
+site_url: https://strandsagents.com
 
 repo_url: https://github.com/strands-agents/sdk-python
 
@@ -59,6 +60,11 @@ markdown_extensions:
 extra_css:
   - stylesheets/extra.css
 
+extra_javascript:
+  # Workaround for site_url breaking mermaid rendering; see the following for more info:
+  # https://github.com/squidfunk/mkdocs-material/issues/3742#issuecomment-1076068038
+  - https://unpkg.com/mermaid@11/dist/mermaid.min.js
+
 nav:
   - User Guide:
     - Welcome: README.md
@@ -146,6 +152,15 @@ plugins:
             docstring_style: google
             show_root_heading: true
             show_source: true
+  - llmstxt:
+      sections:
+        User Guide:
+          - README.md
+          - user-guide/**/*.md
+        Examples:
+          - examples/**/*.md
+        API Reference:
+          - api-reference/*.md
 
 extra:
   social:

requirements.txt

@@ -2,6 +2,6 @@ mike~=2.1.3
 mkdocs~=1.6.1
 mkdocs-macros-plugin~=1.3.7
 mkdocs-material~=9.6.12
-mkdocs-macros-plugin~=1.3.7
 mkdocstrings-python~=1.16.10
+mkdocs-llmstxt~=0.2.0
 strands-agents~=0.1.0