Feat: Add GitHub Copilot Quickstart Guide - WIP

.devcontainer/devcontainer.json

@@ -21,7 +21,11 @@
         "eliostruyf.vscode-hugo-themer",
         "kaellarkin.hugo-shortcode-syntax",
         "davidanson.vscode-markdownlint",
-        "streetsidesoftware.code-spell-checker"
+        "streetsidesoftware.code-spell-checker",
+        "GitHub.codespaces",
+        "GitHub.copilot",
+        "GitHub.copilot-chat",
+        "ms-azuretools.vscode-azure-github-copilot"
       ]
     }
   },

.vscode/mcp.json

@@ -0,0 +1,13 @@
+{
+  "inputs": [],
+  "servers": {
+    "microsoft.docs.mcp": {
+      "type": "http",
+      "url": "https://learn.microsoft.com/api/mcp"
+    },
+    "github": {
+      "url": "https://api.githubcopilot.com/mcp/",
+      "type": "http"
+    }
+  }
+}

docs/content/usage/_index.md

@@ -16,3 +16,5 @@ This section describes usage guidance.
 - [Solution Development]({{% siteparam base %}}/usage/solution-development/)
   - [Bicep]({{% siteparam base %}}/usage/solution-development/bicep/)
   - [Terraform]({{% siteparam base %}}/usage/solution-development/terraform/)
+- [GitHub Copilot + AVM]({{% siteparam base %}}/usage/gh-copilot/)
+  - [Using AVM with GitHub Copilot]({{% siteparam base %}}/usage/gh-copilot/using-avm-with-gh-copilot/)

docs/content/usage/gh-copilot/_index.md

@@ -0,0 +1,14 @@
+---
+draft: false
+title: GitHub Copilot + AVM
+linktitle: GitHub Copilot + AVM
+description: Guidance on using GitHub Copilot with Azure Verified Modules (AVM) to enhance your development workflow and AVM consumption.
+---
+
+This section provides guidance on using GitHub Copilot with Azure Verified Modules (AVM) to enhance your development workflow and AVM consumption.
+
+Whether you are new to AVM or an experienced user, GitHub Copilot can help you write code faster and more efficiently by providing AI-powered code suggestions and completions. It can help both module developers in creating and maintaining AVM modules, as well as solution developers in consuming AVM modules to build solutions.
+
+Review the following sections to learn how to effectively use GitHub Copilot with AVM:
+
+- [Using AVM with GitHub Copilot](using-avm-with-gh-copilot.md): Learn how to set up and configure GitHub Copilot for your development environment.

docs/hugo.toml

@@ -108,30 +108,6 @@ pageRef = '/indexes'
 weight = 2
 params = { alwaysopen = true, collapsibleMenu = true }
 
-  [[menu.defined]]
-    identifier = 'solution-development'
-    parent = 'usage'
-    name = 'Solution Development'
-    pageRef = '/usage/solution-development'
-    weight = 2
-    params = { alwaysopen = false, collapsibleMenu = true }
-
-    [[menu.defined]]
-      identifier = 'bicep-solution-development'
-      parent = 'solution-development'
-      name = 'Bicep'
-      pageRef = '/usage/solution-development/bicep'
-      weight = 1
-      params = { alwaysopen = false, collapsibleMenu = true }
-
-    [[menu.defined]]
-      identifier = 'terraform-solution-development'
-      parent = 'solution-development'
-      name = 'Terraform'
-      pageRef = '/usage/solution-development/terraform'
-      weight = 2
-      params = { alwaysopen = false, collapsibleMenu = true }
-
   # [[menu.defined]]
   #   identifier = 'concepts'
   #   parent = 'usage'
@@ -212,29 +188,69 @@ pageRef = '/usage'
 weight = 3
 params = { alwaysopen = true, collapsibleMenu = true }
 
-[[menu.defined]]
-identifier = 'quickstart'
-parent = 'usage'
-name = 'Quickstart'
-pageRef = '/usage/quickstart'
-weight = 1
-params = { alwaysopen = false, collapsibleMenu = true }
+  [[menu.defined]]
+    identifier = 'quickstart'
+    parent = 'usage'
+    name = 'Quickstart'
+    pageRef = '/usage/quickstart'
+    weight = 1
+    params = { alwaysopen = false, collapsibleMenu = true }
 
-[[menu.defined]]
-identifier = 'bicep-quickstart'
-parent = 'quickstart'
-name = 'Bicep'
-pageRef = '/usage/quickstart/bicep'
-weight = 1
-params = { alwaysopen = false, collapsibleMenu = true }
+    [[menu.defined]]
+      identifier = 'bicep-quickstart'
+      parent = 'quickstart'
+      name = 'Bicep'
+      pageRef = '/usage/quickstart/bicep'
+      weight = 1
+      params = { alwaysopen = false, collapsibleMenu = true }
 
-[[menu.defined]]
-identifier = 'terraform-quickstart'
-parent = 'quickstart'
-name = 'Terraform'
-pageRef = '/usage/quickstart/terraform'
-weight = 2
-params = { alwaysopen = false, collapsibleMenu = true }
+    [[menu.defined]]
+      identifier = 'terraform-quickstart'
+      parent = 'quickstart'
+      name = 'Terraform'
+      pageRef = '/usage/quickstart/terraform'
+      weight = 2
+      params = { alwaysopen = false, collapsibleMenu = true }
+
+  [[menu.defined]]
+    identifier = 'solution-development'
+    parent = 'usage'
+    name = 'Solution Development'
+    pageRef = '/usage/solution-development'
+    weight = 2
+    params = { alwaysopen = false, collapsibleMenu = true }
+
+    [[menu.defined]]
+      identifier = 'bicep-solution-development'
+      parent = 'solution-development'
+      name = 'Bicep'
+      pageRef = '/usage/solution-development/bicep'
+      weight = 1
+      params = { alwaysopen = false, collapsibleMenu = true }
+
+    [[menu.defined]]
+      identifier = 'terraform-solution-development'
+      parent = 'solution-development'
+      name = 'Terraform'
+      pageRef = '/usage/solution-development/terraform'
+      weight = 2
+      params = { alwaysopen = false, collapsibleMenu = true }
+
+  [[menu.defined]]
+    identifier = 'github-copilot'
+    parent = 'usage'
+    name = 'GitHub Copilot + AVM'
+    pageRef = '/usage/gh-copilot'
+    weight = 3
+    params = { alwaysopen = false, collapsibleMenu = true }
+
+    [[menu.defined]]
+      identifier = 'github-copilot-using-with-avm'
+      parent = 'github-copilot'
+      name = 'Using AVM with GitHub Copilot'
+      pageRef = '/usage/gh-copilot/using-avm-with-gh-copilot'
+      weight = 1
+      params = { alwaysopen = false, collapsibleMenu = true }
 
 [[menu.defined]]
 identifier = 'specs-defs'