microsoft · shivashanmugam · Apr 17, 2026 · Apr 20, 2026 · Apr 21, 2026 · Apr 21, 2026
diff --git a/README.md b/README.md
@@ -92,6 +92,12 @@ The `WritingBot` will read and write the files inside `code` folder based on spe
 
 The MicroBots create a containerized environment and mount the specified directory with restricting the permissions to read-only or read/write based on Bot used. It ensures that the AI agents operate within defined boundaries which enhances security and control over code modifications as well as protecting the local environment.
 
+## 🎯 Getting Started
+
+Ready to build your first Microbot project? Follow the step-by-step onboarding guide:
+
+➡️ **[Get Started with Microbots](https://microsoft.github.io/microbots/getting-started/prerequisites/)**
+
 #Legal Notice
 
 Trademarks This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft’s Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party’s policies.
diff --git a/...aged-identity-setup/mi-01-create-form.png → ...aged-identity-setup/mi-01-create-form.png b/...aged-identity-setup/mi-01-create-form.png → ...aged-identity-setup/mi-01-create-form.png
diff --git a/...managed-identity-setup/mi-02-overview.png → ...managed-identity-setup/mi-02-overview.png b/...managed-identity-setup/mi-02-overview.png → ...managed-identity-setup/mi-02-overview.png
diff --git a/...-managed-identity-setup/sc-01-new-arm.png → ...-managed-identity-setup/sc-01-new-arm.png b/...-managed-identity-setup/sc-01-new-arm.png → ...-managed-identity-setup/sc-01-new-arm.png
diff --git a/...ity-setup/sc-02-managed-identity-form.png → ...ity-setup/sc-02-managed-identity-form.png b/...ity-setup/sc-02-managed-identity-form.png → ...ity-setup/sc-02-managed-identity-form.png
diff --git a/docs/authentication.md → docs/advanced/authentication.md b/docs/authentication.md → docs/advanced/authentication.md
diff --git a/docs/guides/azure-managed-identity-setup.md → .../advanced/azure-managed-identity-setup.md b/docs/guides/azure-managed-identity-setup.md → .../advanced/azure-managed-identity-setup.md
@@ -259,5 +259,5 @@ One identity, one service connection, many Microbots pipelines.
 ## Next Steps
 
 - **Conceptual background** → [Understanding RBAC & Authentication](../blog/rbac-authentication.md)
-- **All authentication options** → [Authentication Setup](../authentication.md)
+- **All authentication options** → [Authentication Setup](authentication.md)
 - **Why secret-less matters** → [Microbots: Safety First Agentic Workflow](../blog/microbots-safety-first-ai-agent.md)
diff --git a/docs/copilot-bot.md → docs/advanced/bots/copilot-bot.md b/docs/copilot-bot.md → docs/advanced/bots/copilot-bot.md