dedicated-guides

Author: rebecca bausinger

docs/new-concept-copilot.md

@@ -93,5 +93,13 @@ All conversations with meshStack Copilot, including all data provided to the mod
 
 ## Related Resources
 
-- [How to use meshStack Copilot Guide](new-guide-how-to-copilot.md)
+### Concepts
+
+- [Copilot](new-concept-copilot.md)
 - [Security FAQ](security-faq.md)
+
+### Guides
+
+- [How to use meshStack Copilot Guide](new-guide-how-to-copilot.md)
+- [How to Discover Services Guide](new-guide-how-to-discover-services.md)
+- [How to Generate Building Block Documentation Guide](new-guide-how-to-generate-building-block-documentation.md)

docs/new-guide-how-to-copilot.md

@@ -7,35 +7,7 @@ title: How to Use meshStack Copilot
 This guide shows you how to get the most out of meshStack Copilot, your AI-powered assistant for discovering platform services, generating documentation, and improving your cloud experience.
 :::
 
-## Challenge
-
-Finding the right platform services, keeping documentation up to date, and understanding user needs can be tough. meshStack Copilot helps you solve these challenges by providing instant answers, documentation support, and actionable insights—all in one place.
-
-## Discover Platform Services
-
-### Prerequisites
-
-- You have access to meshPanel with Copilot enabled.
-
-### Step by Step Guide
-
-1. Click the Copilot sheep icon at the top right corner of any meshPanel screen.
-2. Use the chat interface to ask questions about available services, policies, or how to get started with a specific tool.
-3. Copilot will recommend services and guide you on how to request access.
-
-## Generate Service Documentation
-
-### Prerequisites
-
-- You have access to meshPanel with Copilot enabled.
-- You are defining a building block or service.
-
-### Step by Step Guide
-
-1. Use Copilot’s “Get help” button when defining a building block or service.
-2. Answer Copilot’s prompts to generate best-practices documentation, including descriptions, usage instructions, and troubleshooting guides.
-
-## Improve Services with User Insights
+## Improve Answers with User Insights
 
 ### Prerequisites
 
@@ -66,5 +38,4 @@ Use Copilot’s “Get help” button for context-aware suggestions and faster w
 
 ### Concepts
 
-- [meshStack Copilot Concept](new-concept-copilot.md)
-- [Marketplace](new-concept-marketplace.md)
+- [Copilot](new-concept-copilot.md)

docs/new-guide-how-to-discover-services.md

@@ -0,0 +1,26 @@
+---
+id: new-guide-how-to-discover-services
+title: How to Discover Services
+---
+
+:::note What is this guide about?
+This guide shows you how to use Copilot in meshPanel to discover available services, ask questions, and get recommendations tailored to your needs.
+:::
+
+## Prerequisites
+
+- You have access to meshPanel with Copilot enabled.
+
+## Step by Step Guide
+
+1. Click the Copilot sheep icon at the top right corner of any meshPanel screen.
+2. Use the chat interface to ask questions about available services, policies, or how to get started with a specific tool.
+3. Copilot will recommend services and guide you on how to request access.
+
+## Related Resources
+
+### Concepts
+
+- [Marketplace](new-concept-marketplace)
+- [Platform](new-concept-platform)
+- [Copilot](new-concept-copilot.md)

docs/new-guide-how-to-generate-building-block-documentation.md

@@ -0,0 +1,26 @@
+---
+id: new-guide-how-to-generate-building-block-documentation
+title: How to Generate Building Block Documentation
+---
+
+:::note What is this guide about?
+This guide shows you how to use Copilot in meshPanel to quickly generate high-quality documentation for your building blocks and services.
+:::
+
+## Prerequisites
+
+- You have access to meshPanel with Copilot enabled.
+- You are defining a building block or service.
+
+## Step by Step Guide
+
+1. Use Copilot’s “Get help” button when defining a building block or service.
+2. Answer Copilot’s prompts to generate best-practices documentation, including descriptions, usage instructions, and troubleshooting guides.
+
+## Related Resources
+
+### Concepts
+
+- [Building Block](new-concept-buildingblock)
+- [Service Documentation](new-concept-marketplace)
+- [Copilot](new-concept-copilot.md)

sidebars.ts

@@ -328,7 +328,9 @@ const sidebars: SidebarsConfig = {
           label: 'Developer Engagement',
           items: [
             'new-guide-how-to-provide-security-contact',
-            'new-guide-how-to-copilot'
+            'new-guide-how-to-copilot',
+            'new-guide-how-to-discover-services',
+            'new-guide-how-to-generate-building-block-documentation'
           ],
         },
         {