Draft code completed pre fabian tweak

Author: TuannasCodeCatastrophe

app/_how-tos/connect-azure-devops-to-the-konnect-catalog-with-the-konnect-api.md

@@ -10,7 +10,7 @@ tools:
   - konnect-api
 tags:
   - integrations
-  - azure-devops
+
 search_aliases:
   - azure repos
   - devops
@@ -34,61 +34,110 @@ prereqs:
       include_content: prereqs/service-catalog-integration-role
       icon_url: /assets/icons/kogo-white.svg
     - title: Create and configure an Azure account
-       content: |
+      content: |
         You need to configure the following in Azure DevOps:
         - An [Azure DevOps account](https://azure.microsoft.com/en-gb/pricing/purchase-options/azure-account?icid=devops).
         - An [Azure DevOps personal access token (PAT)](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops&tabs=Windows) with `Code: Read` permission.
-        {:.info}
-        > Your PAT expires after one year. Make sure that you renew it after it expires.
+        
+        {:.warning}
+        > Your PAT expires after one year. Make sure that you renew it when it expires.
+
 ---
 
 ## Configure the Azure DevOps integration
 
 Before you can discover Azure DevOps repositories in Catalog, you must configure the integration:
 
-[insert codeblock]
+{% konnect_api_request %}
+url: /v1/integration-instances
+status_code: 201
+method: POST
+body:
+  integration_name: "azure-devops"
+  name: "azure-devops"
+  display_name: "Azure DevOps"
+  config:
+    organization: "kong-konnect"
+{% endkonnect_api_request %}
 
 Export the ID of your Azure DevOps integration:
 
-[insert codeblock]
+```sh
+export AZUREDEVOPS_INTEGRATION_ID='YOUR-INTEGRATION-ID'
+```
 
 Next, authorize the integration with your Azure DevOps PAT:
 
-[insert codeblock]
+{% konnect_api_request %}
+url: /v1/integration-instances/$AZUREDEVOPS_INTEGRATION_ID/auth-credential
+status_code: 201
+method: POST
+body:
+  type: multi_key_auth
+  config:
+    headers:
+      - name: authorization
+        key: $AZUREDEVOPS_PAT
+{% endkonnect_api_request %}
 
-Once authorized, resources from your Azure DevOps account will be discoverable in the UI.
+Once authorized, resources from your Azure DevOps account are discoverable in the UI.
 
 ## Create a Service in Catalog
 
-Create a service that you’ll map to your Azure DevOps resources:
+Create a service to map to your Azure DevOps resources:
 
-[insert codeblock]
+{% konnect_api_request %}
+url: /v1/catalog-services
+status_code: 201
+method: POST
+body:
+  name: "user-service"
+  display_name: "User Service"
+{% endkonnect_api_request %}
 
 Export the service ID:
 
-[insert codeblock]
+```sh
+export AZUREDEVOPS_SERVICE_ID="YOUR-SERVICE-ID"
+```
 
 ## List Azure Dev Ops resources
 
-Before you can map your Azure DevOps resources to a service in {{site.konnect_catalog}}, you first need to find the resources that are pulled in from Azure DevOps:
+Before you map Azure DevOps resources to a service in Catalog, locate the resources that {{site.konnect_short_name}} ingests from Azure DevOps:
 
-[insert codeblock]
+{% konnect_api_request %}
+url: /v1/resources?filter%5Bintegration.name%5D=azure-devops
+status_code: 200
+method: GET
+{% endkonnect_api_request %}
 
-{:.info}
-> If you don't immediately see resources, you might need to manually sync your Azure DevOps integration. From the {{site.konnect_short_name}} UI, navigate to the Azure DevOps integration that you just installed. Then, from the  **Actions** dropdown menu, select **Sync Now**.
+ If you don't immediately see resources, try manually syncing your Azure DevOps integration. From the {{site.konnect_short_name}} UI, navigate to the Azure DevOps integration that you just installed. Then, from the  **Actions** dropdown menu, select **Sync Now**.
 
 Export the resource ID you want to map to the service:
 
-[insert codeblock]
+```sh
+export AZUREDEVOPS_RESOURCE_ID="YOUR-RESOURCE-ID"
+```
 
 ## Map resources to a service
 
 Now, map the Azure DevOps resource to the service:
 
-[insert codeblock]
+{% konnect_api_request %}
+url: /v1/resource-mappings
+status_code: 201
+method: POST
+body:
+  service: $AZUREDEVOPS_SERVICE_ID
+  resource: $AZUREDEVOPS_RESOURCE_ID
+{% endkonnect_api_request %}
 
 ## Validate the mapping
 
 To confirm that the Azure DevOps resource is now mapped to the intended service, list the service’s mapped resources:
 
-[insert codeblock]
+{% konnect_api_request %}
+url: /v1/catalog-services/$AZUREDEVOPS_SERVICE_ID/resources
+status_code: 200
+method: GET
+{% endkonnect_api_request %}

app/_how-tos/connect-azure-devops-to-the-konnect-catalog-with-the-konnect-ui.md

@@ -1,5 +1,5 @@
 ---
-title: Connect Azure DevOps repositories to Catalog with the {{site.konnect_short_name}} UI
+title: Connect Azure DevOps repositories to Catalog with the konnect UI
 content_type: how_to
 description: Learn how to connect Azure DevOps repositories to your {{site.konnect_catalog}} services in {{site.konnect_short_name}} using the UI.
 products:
@@ -8,7 +8,6 @@ works_on:
   - konnect
 tags:
   - integrations
-  - azure-devops
 search_aliases:
   - devops
   - azure repos
@@ -25,14 +24,14 @@ related_resources:
 automated_tests: false
 tldr:
   q: How do I connect Azure DevOps repositories to {{site.konnect_short_name}}?
-  a: Install the Azure DevOps integration in {{site.konnect_short_name}}, authorize it with a Personal Access Token (PAT) that has Code → Read access, then map an Azure DevOps repository to your {{site.konnect_catalog}} service.
+  a: Install the Azure DevOps integration in {{site.konnect_short_name}}, authorize it with a Personal Access Token (PAT) that has Code:Read access, then map an Azure DevOps repository to your {{site.konnect_catalog}} service.
 prereqs:
   inline:
     - title: "{{site.konnect_short_name}} roles"
       include_content: prereqs/service-catalog-integration-role
       icon_url: /assets/icons/kogo-white.svg
     - title: Create and configure an Azure account
-       content: |
+      content: |
         You need to configure the following in Azure DevOps:
         - An [Azure DevOps account](https://azure.microsoft.com/en-gb/pricing/purchase-options/azure-account?icid=devops).
         - An [Azure DevOps personal access token (PAT)](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops&tabs=Windows) with `Code: Read` permission.

app/catalog/integrations/azure-devops.md

@@ -10,7 +10,7 @@ products:
 
 tags:
   - integrations
-  - azuredevops
+
 search_aliases:
   - service catalog
 breadcrumbs:
@@ -19,7 +19,8 @@ breadcrumbs:
 
 works_on:
     - konnect
-description: 
+description: "description: Provides information about the Azure DevOps integration, which lets the Konnect Catalog read repository metadata from Azure DevOps and use it for service mapping and governance workflows."
+
 
 related_resources:
   - text: "{{site.konnect_catalog}}"
@@ -30,7 +31,7 @@ related_resources:
     url: /how-to/connect-azure-devops-to-the-konnect-catalog-with-the-konnect-ui/
 ---
 
-The Azure DevOps integration lets Konnect Catalog securely read and ingest repository metadata from Azure DevOps using a PAT with `Code: Read` access. Teams can reference and manage their source-code assets inside {{site.konnect_catalog}} and prepare for future governance and scorecard workflows.
+The Azure DevOps integration lets Konnect Catalog securely read and ingest repository metadata from Azure DevOps using a PAT with `Code:Read` access. Teams can reference and manage their source-code assets inside {{site.konnect_catalog}} and prepare for future governance and scorecard workflows.
 
 For a complete tutorial, choose one of the following:
 - [Connect Azure DevOps repositories to Catalog with the Konnect API](/how-to/connect-azure-devops-to-the-konnect-catalog-with-the-konnect-api/)
@@ -39,7 +40,7 @@ For a complete tutorial, choose one of the following:
 ### Prerequisites
 You need to configure the following:
 - An [Azure DevOps account](https://azure.microsoft.com/en-gb/pricing/purchase-options/azure-account?icid=devops)
-- An [Azure DevOps personal access token (PAT)]([Azure DevOps personal access token (PAT)](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops&tabs=Windows) with `Code: Read` permission.
+- An [Azure DevOps personal access token (PAT)](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops&tabs=Windows) with `Code:Read` permission.
 
 ### Configure the integration
 {% navtabs "azure-devops-integration" %}