microsoft · shivashanmugam · Apr 17, 2026 · Apr 20, 2026 · Apr 21, 2026 · Apr 21, 2026
diff --git a/docs/examples/microbots_introduction/code/app.ts b/docs/examples/microbots_introduction/code/app.ts
@@ -0,0 +1,13 @@
+// app.ts — A simple greeting function with a syntax error
+function greet(name: string) {
+    const message: string = `Hello, ${name}!`
+    console.log(message)
+}
+
+// Missing closing parenthesis on the type annotation
+function add(a: number, b: number: number {
+    return a + b;
+}
+
+greet("Microbots");
+console.log(add(2, 3));
diff --git a/docs/examples/microbots_introduction/log_analysis_bot.py b/docs/examples/microbots_introduction/log_analysis_bot.py
@@ -0,0 +1,20 @@
+import logging
+
+logging.basicConfig(level=logging.INFO)
+
+from dotenv import load_dotenv
+
+load_dotenv()
+
+from microbots import LogAnalysisBot
+
+my_bot = LogAnalysisBot(
+    model="azure-openai/gpt-5-swe-agent",
+    folder_to_mount="code",
+)
+
+result = my_bot.run(
+    file_name="code/build.log",
+    timeout_in_seconds=600,
+)
+print(result.result)
diff --git a/docs/index.md → docs/getting-started/home.md b/docs/index.md → docs/getting-started/home.md
@@ -44,7 +44,7 @@ print(data.results)
 
 ## ⚙️ How it works
 
-![Overall Architecture](images/overall_architecture.png)
+![Overall Architecture](../images/overall_architecture.png)
 
 MicroBots creates a containerized environment and mounts the specified directory, restricting permissions to read-only or read/write based on the Bot used. This ensures AI agents operate within defined boundaries, enhancing security and control over code modifications while protecting the local environment.
 

diff --git a/docs/authentication.md → docs/guides/advanced/authentication.md b/docs/authentication.md → docs/guides/advanced/authentication.md
diff --git a/docs/copilot-bot.md → docs/guides/bots/copilot-bot.md b/docs/copilot-bot.md → docs/guides/bots/copilot-bot.md
diff --git a/...uides/bots/microbots-introduction-installation-guide-creating-your-first-bot.md b/...uides/bots/microbots-introduction-installation-guide-creating-your-first-bot.md
diff --git a/docs/guides/index.md b/docs/guides/index.md
@@ -0,0 +1,22 @@
+# Guides
+
+Explore the Microbots guides to learn how to use the framework effectively.
+
+## Bots
+
+| Guide | Description |
+|-------|-------------|
+| [Microbots : Introduction, Installation Guide and Creating Your First MicroBot](bots/microbots-introduction-installation-guide-creating-your-first-bot.md) | Get started with Microbots — learn the basics, install prerequisites, and create your first LogAnalysisBot |
+| [CopilotBot](bots/copilot-bot.md) | Use CopilotBot for AI-assisted coding workflows |
+
+## Tools
+
+| Guide | Description |
+|-------|-------------|
+| [Custom Tool Integration Walkthrough](tools/tesseract_ocr_tool_use.md) | Build and integrate custom tools with Microbots |
+
+## Advanced
+
+| Guide | Description |
+|-------|-------------|
+| [Authentication](advanced/authentication.md) | Configure Azure AD tokens, managed identity, and service principals |
diff --git a/docs/blog/guides/tesseract_ocr_tool_use.md → docs/guides/tools/tesseract_ocr_tool_use.md b/docs/blog/guides/tesseract_ocr_tool_use.md → docs/guides/tools/tesseract_ocr_tool_use.md
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -36,17 +36,23 @@ markdown_extensions:
   - pymdownx.tabbed:
       alternate_style: true
   - admonition
+  - pymdownx.details
   - tables
   - attr_list
+  - md_in_html
 
 nav:
   - Getting Started:
-    - Home: index.md
+    - Home: getting-started/home.md
   - Guides:
-    - CopilotBot: copilot-bot.md
-    - Authentication: authentication.md
+    - guides/index.md
+    - Bots:
+      - "Microbots : Introduction, Installation Guide and Creating Your First MicroBot": guides/bots/microbots-introduction-installation-guide-creating-your-first-bot.md
+    - CopilotBot: guides/bots/copilot-bot.md
     - Tools:
-      - "Custom Tool Integration Walkthrough": blog/guides/tesseract_ocr_tool_use.md
+      - "Custom Tool Integration Walkthrough": guides/tools/tesseract_ocr_tool_use.md
+    - Advanced:
+      - Authentication: guides/advanced/authentication.md
   - Blogs:
     - blog/index.md
     - "Microbots : Safety First Agentic Workflow": blog/microbots-safety-first-ai-agent.md