fixing errors in pr build

Author: microsoftshawarma

articles/trusted-signing/TOC.yml

@@ -8,16 +8,16 @@
       href: overview.md
   - name: How-To
     items:
-    - name: How-To sign with Trusted Signing
-      href: how-to.md
+    - name: Signing Integrations with Trusted Signing
+      href: how-to-signing-integrations.md
   - name: Quickstart
     items:
     - name: Quickstart onboarding
       href: quickstart.md
   - name: Tutorial
     items:
-    - name: Trusted Signing tutorial
-      href: tutorial.md
+    - name: Assigning Roles in Trusted Signing
+      href: tutorial-assign-roles.md
   - name: FAQ
     items:
     - name: FAQ about Trusted Signing

articles/trusted-signing/how-to-signing-integrations.md

@@ -9,6 +9,8 @@ ms.date: 03/21/2024 #Required; mm/dd/yyyy format.
 ms.custom: template-how-to-pattern #Required; leave this attribute/value as-is.
 ---
 
+# Implement Signing Integrations with Trusted Signing
+
 Trusted Signing currently supports the following signing integrations: 
 •	SignTool
 •	GitHub Action 
@@ -21,21 +23,21 @@ This article explains how to set up each of the above Trusted Signing signing in
 
 
 ## Set up SignTool with Trusted Signing
-This section explains how to set up SignTool to use with Trusted Signing. For more detailed signing with SignTool, check out [Tutorial Public Trust](tutorial.md).
+This section explains how to set up SignTool to use with Trusted Signing.
 
 Prerequisites: 
-•	A Trusted Signing account, Identity Validation, and Certificate Profile.
-•	Ensure there are proper individual or group role assignments for signing (“Trusted Signing Certificate Profile Signer” role).
+* A Trusted Signing account, Identity Validation, and Certificate Profile.
+* Ensure there are proper individual or group role assignments for signing (“Trusted Signing Certificate Profile Signer” role).
 
 Overview of steps:  
 1.	[Download and install SignTool.](#download-and-install-signtool)
-2.	[Download and install the .NET 6 Runtime.](#download-and-install-.net-6.0-runtime)
-3.	[Download and install the Trusted Signing Dlib Package.](download-and-install-trusted-signing-dlib-package)
+2.	[Download and install the .NET 6 Runtime.](#download-and-install-net-60-runtime)
+3.	[Download and install the Trusted Signing Dlib Package.](#download-and-install-trusted-signing-dlib-package)
 4.	[Create JSON file to provide your Trusted Signing account and Certificate Profile.](#create-json-file)
-5.	[Invoke SignTool.exe to sign a file.](invoke-signtool-to-sign-a-file)
+5.	[Invoke SignTool.exe to sign a file.](#invoke-signtool-to-sign-a-file)
 
 ### Download and install SignTool
-Trusted Signing requires the use of SignTool.exe to sign files on Windows, specifically the version of SignTool.exe from the Windows 10 SDK 10.0.19041 or higher. You can install the full Windows 10 SDK via the Visual Studio Installer or [download and install it separately](https://developer.microsoft.com/en-US/windows/downloads/windows-10-sdk/).
+Trusted Signing requires the use of SignTool.exe to sign files on Windows, specifically the version of SignTool.exe from the Windows 10 SDK 10.0.19041 or higher. You can install the full Windows 10 SDK via the Visual Studio Installer or [download and install it separately](https://developer.microsoft.com/en-us/windows/downloads/windows-sdk/).
 
 
 To download and install SignTool:
@@ -85,12 +87,12 @@ To sign using Trusted Signing, you need to provide the details of your Trusted S
 
 | Region       | Region Class Fields  | Endpoint URI value  |
 |--------------|-----------|------------|
-| East US  | EastUS  | https://eus.codesigning.azure.net |
-| West US   | WestUS  | https://wus.codesigning.azure.net |
-| West Central US  | WestCentralUS  | https://wcus.codesigning.azure.net/ |
-| West US 2   | WestUS2   | https://wus2.codesigning.azure.net/ |
-| North Europe   | NorthEurope   | https://neu.codesigning.azure.net   |
-| West Europe   | WestEurope   | https://weu.codesigning.azure.net  |
+| East US  | EastUS  | `https://eus.codesigning.azure.net` |
+| West US   | WestUS  | `https://wus.codesigning.azure.net` |
+| West Central US  | WestCentralUS  | `https://wcus.codesigning.azure.net/` |
+| West US 2   | WestUS2   | `https://wus2.codesigning.azure.net/` |
+| North Europe   | NorthEurope   | `https://neu.codesigning.azure.net`   |
+| West Europe   | WestEurope   | `https://weu.codesigning.azure.net`  |
 
 * The optional `"CorrelationId"` field is an opaque string value that you can provide to correlate sign requests with your own workflows such as build identifiers or machine names.
 
@@ -106,10 +108,10 @@ Complete the following steps to invoke SignTool to sign a file for you:
 * Both x86 and x64 versions of SignTool.exe are provided as part of the Windows SDK - ensure you reference the corresponding version of Azure.CodeSigning.Dlib.dll. The above example is for the x64 version of SignTool.exe.
 * You must make sure you use the recommended Windows SDK version in the dependencies listed at the beginning of this article. Otherwise our dlib won’t work. 
 
-Trusted Signing certificates have a 3-day validity, so timestamping is critical for continued successful validation of a signature beyond that 3-day validity period. Trusted Signing recommends the use of Trusted Signing’s Microsoft Public RSA Time Stamping Authority: http://timestamp.acs.microsoft.com/.
+Trusted Signing certificates have a 3-day validity, so timestamping is critical for continued successful validation of a signature beyond that 3-day validity period. Trusted Signing recommends the use of Trusted Signing’s Microsoft Public RSA Time Stamping Authority: `http://timestamp.acs.microsoft.com/`.
 
 ## Use other signing integrations with Trusted Signing 
-This section explains how to set up other not [SignTool](#setup-signtool-with-trusted-signing) signing integrations with Trusting Signing.
+This section explains how to set up other not [SignTool](#set-up-signtool-with-trusted-signing) signing integrations with Trusting Signing.
 
 * GitHub Action – To use the GitHub action for Trusted Signing, visit [Azure Code Signing · Actions · GitHub Marketplace](https://github.com/marketplace/actions/azure-code-signing) and follow the instructions to set up and use GitHub action.
 

articles/trusted-signing/index.yml

@@ -18,18 +18,24 @@ landingContent:
 # Cards and links should be based on top customer tasks or top subjects
 # Start card title with a verb
   # Card 
-  - title: About Trusted Signing
+  - title: Signing Integrations
     linkLists:
-      - linkListType: overview
+      - linkListType: how-to-guide
         links:
-          - text: What is Trusted Signing?
-            url: overview.md
-  - title: Setting Up Signing
+          - text: Implement Signing Integrations with Trusted Signing
+            url: how-to-signing-integrations.md
+  - title: Overview
+      linkLists:
+        - linkListType: overview
+          links:
+            - text: Overview of Trusted Signing
+              url: overview.md
+  - title: Assigning Roles in Trusted Signing
     linkLists:
-      - linkListType: how-to-guide
+      - linkListType: tutorial
         links:
-          - text: Creating resources and signing with the service
-            url: how-to.md
+          - text: Tutorial on assigning roles in the Trusted Signing service
+            url: tutorial-assign-roles.md
   - title: Learn about Signing
     linkLists:
       - linkListType: concept

articles/trusted-signing/tutorial-assign-roles.md

@@ -7,8 +7,9 @@ ms.service: azure-code-signing #Required; service per approved list. slug assign
 ms.topic: tutorial #Required; leave this attribute/value as-is.
 ms.date: 03/21/2023 #Required; mm/dd/yyyy format.
 ---
+# Assigning roles in Trusted Signing
 
-The Trusting Signing service has a few Trusted Signing specific roles (in addition to the standard Azure roles). Use [Azure role-based access control (RBAC)](https://docs.microsoft.com/en-us/azure/role-based-access-control/overview) to assign user and group roles for the Trusted Signing specific roles. In this tutorial, you review the different Trusted Signing supported roles and assign roles to your Trusted Signing account on the Azure portal. 
+The Trusting Signing service has a few Trusted Signing specific roles (in addition to the standard Azure roles). Use [Azure role-based access control (RBAC)](https://docs.microsoft.com/azure/role-based-access-control/overview) to assign user and group roles for the Trusted Signing specific roles. In this tutorial, you review the different Trusted Signing supported roles and assign roles to your Trusted Signing account on the Azure portal. 
 
 ## Supported roles with Trusting Signing
 The following table lists the roles that Trusted Signing supports, including what each role can access within the service’s resources. 
@@ -30,8 +31,8 @@ Complete the following steps to assign roles in Trusted Signing.
 2.	Select on the **Roles** tab and search "Trusted Signing". You can see in the screenshot below the two custom roles.
 ![Screenshot of Azure portal UI with the Trusted Signing custom RBAC roles.](./media/trusted-signing-rbac-roles.png)
 
-3. To assign these roles, select on the **Add** drop down and select **Add role assignment**. Follow the [Assign roles in Azure](https://docs.microsoft.com/en-us/azure/role-based-access-control/role-assignments-portal?tabs=current) guide to assign the relevant roles to your identities.
+3. To assign these roles, select on the **Add** drop down and select **Add role assignment**. Follow the [Assign roles in Azure](https://docs.microsoft.com/azure/role-based-access-control/role-assignments-portal?tabs=current) guide to assign the relevant roles to your identities.
 
 ## Related content 
-* [What is Azure role-based access control (RBAC)?](https://docs.microsoft.com/en-us/azure/role-based-access-control/overview)
+* [What is Azure role-based access control (RBAC)?](https://docs.microsoft.com/azure/role-based-access-control/overview)
 * [Trusted Signing Quickstart](quickstart.md)