Merge pull request #280887 from dlepow/apicvsc

[APIC] VSCode extension updates - July

Author: Stacyrch140

articles/api-center/media/use-vscode-extension/view-api-documentation.png

@@ -4,7 +4,7 @@ description: Build, discover, try, and consume APIs from your Azure API center u
 author: dlepow
 ms.service: api-center
 ms.topic: how-to
-ms.date: 05/17/2024
+ms.date: 07/15/2024
 ms.author: danlep 
 ms.custom: 
 # Customer intent: As a developer, I want to use my Visual Studio Code environment to build, discover, try, and consume APIs in my organization's API center.
@@ -40,6 +40,7 @@ The following Visual Studio Code extensions are optional and needed only for cer
 * [Microsoft Kiota extension](https://marketplace.visualstudio.com/items?itemName=ms-graph.kiota) - to generate API clients
 * [Spectral extension](https://marketplace.visualstudio.com/items?itemName=stoplight.spectral) - to run shift-left API design conformance checks in Visual Studio Code
 * [Optic CLI](https://github.com/opticdev/optic) - to detect breaking changes between API specification documents
+* [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) - to generate OpenAPI specification files from API code
 
 ## Setup
 
@@ -83,6 +84,12 @@ Visual Studio Code will open a diff view between the two API specifications. Any
 
 :::image type="content" source="media/use-vscode-extension/breaking-changes.png" alt-text="Screenshot of breaking changes detected in Visual Studio Code." lightbox="media/use-vscode-extension/breaking-changes.png":::
 
+## Generate OpenAPI specification file from API code 
+ 
+Use the power of GitHub Copilot with the Azure API Center extension for Visual Studio Code to create an OpenAPI specification file from your API code. Right click on the API code, select **Copilot** from the options, and select **Generate API documentation**. This will create an OpenAPI specification file.
+
+After generating the OpenAPI specification file and checking for accuracy, you can register the API with your API center using the **Azure API Center: Register API** command.
+
 ## Discover APIs
 
 Your API center resources appear in the tree view on the left-hand side. Expand an API center resource to see APIs, versions, definitions, environments, and deployments.
@@ -105,6 +112,9 @@ You can view the documentation for an API definition in your API center and try
     > [!NOTE]
     > Depending on the API, you might need to provide authorization credentials or an API key to try the API.
 
+    > [!TIP]
+    > You can also use the extension to generate API documentation in Markdown, a format that's easy to maintain and share with end users. Right-click on the definition, and select **Generate Markdown**.
+
 ## Generate HTTP file
 
 You can view a `.http` file based on the API definition in your API center. If the REST Client extension is installed, you can make requests directory from the Visual Studio Code editor. This feature is only available for OpenAPI-based APIs in your API center.