Use learn.microsoft.com in generated packages (#2977)

jeremymeng · Jeremy Meng · web-flow · commit bc4b982c731b · 2025-01-06T12:13:50.000+08:00
* Use `learn.microsoft.com` in generated packages

instead of `docs.microsoft.com`

* update test baselines

* update unit tests

---------

Co-authored-by: Jeremy Meng &lt;jeremy.ymeng@gmail.com.com&gt;
diff --git a/packages/autorest.typescript/src/generators/static/hlcREADME.md.hbs b/packages/autorest.typescript/src/generators/static/hlcREADME.md.hbs
@@ -59,7 +59,7 @@ npm install @azure/identity
 
 You will also need to **register a new AAD application and grant access to {{ serviceName}}** by assigning the suitable role to your service principal (note: roles such as `"Owner"` will not grant the necessary permissions).
 
-For more information about how to create an Azure AD Application check out [this guide](https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal).
+For more information about how to create an Azure AD Application check out [this guide](https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal).
 
 {{#if azureArm}}
 ```javascript
@@ -146,7 +146,7 @@ If you'd like to contribute to this library, please read the [contributing guide
 {{#if impressionURL}}![Impressions]({{ impressionURL }})
 {{/if}}
 
-[azure_cli]: https://docs.microsoft.com/cli/azure
+[azure_cli]: https://learn.microsoft.com/cli/azure
 [azure_sub]: https://azure.microsoft.com/free/
 [azure_sub]: https://azure.microsoft.com/free/
 [azure_portal]: https://portal.azure.com
diff --git a/packages/autorest.typescript/src/generators/static/packageFileGenerator.ts b/packages/autorest.typescript/src/generators/static/packageFileGenerator.ts
@@ -238,7 +238,7 @@ function regularAutorestPackage(
       productName: description,
       productSlugs: ["azure"],
       disableDocsMs: true,
-      apiRefLink: `https://docs.microsoft.com/javascript/api/${clientPackageName}${apiRefUrlQueryParameter}`
+      apiRefLink: `https://learn.microsoft.com/javascript/api/${clientPackageName}${apiRefUrlQueryParameter}`
     };
   }
   return packageInfo;
diff --git a/packages/autorest.typescript/src/generators/static/readmeFileGenerator.ts b/packages/autorest.typescript/src/generators/static/readmeFileGenerator.ts
@@ -155,7 +155,7 @@ function createMetadata(
     clientDescriptiveName: `${serviceName} client`,
     description: codeModel.info?.description,
     apiRefURL: azureHuh
-      ? `https://docs.microsoft.com/javascript/api/${clientPackageName}${apiRefUrlQueryParameter}`
+      ? `https://learn.microsoft.com/javascript/api/${clientPackageName}${apiRefUrlQueryParameter}`
       : undefined,
     packageNPMURL: `https://www.npmjs.com/package/${clientPackageName}`,
     contributingGuideURL: repoURL && `${repoURL}/blob/main/CONTRIBUTING.md`,
diff --git a/packages/autorest.typescript/test/rlcIntegration/generated/dpgCustomization/package.json b/packages/autorest.typescript/test/rlcIntegration/generated/dpgCustomization/package.json
@@ -87,6 +87,6 @@
     "productName": "@msinternal/dpg-customization-rest",
     "productSlugs": ["azure"],
     "disableDocsMs": true,
-    "apiRefLink": "https://docs.microsoft.com/javascript/api/@msinternal/dpg-customization-rest"
+    "apiRefLink": "https://learn.microsoft.com/javascript/api/@msinternal/dpg-customization-rest"
   }
 }
diff --git a/packages/autorest.typescript/test/smoke/generated/arm-package-subscriptions-2019-06/package.json b/packages/autorest.typescript/test/smoke/generated/arm-package-subscriptions-2019-06/package.json
@@ -100,6 +100,6 @@
     "productName": "",
     "productSlugs": ["azure"],
     "disableDocsMs": true,
-    "apiRefLink": "https://docs.microsoft.com/javascript/api/@msinternal/arm-package-subscriptions-2019-06?view=azure-node-preview"
+    "apiRefLink": "https://learn.microsoft.com/javascript/api/@msinternal/arm-package-subscriptions-2019-06?view=azure-node-preview"
   }
 }
diff --git a/packages/autorest.typescript/test/smoke/generated/compute-resource-manager/package.json b/packages/autorest.typescript/test/smoke/generated/compute-resource-manager/package.json
@@ -102,6 +102,6 @@
     "productName": "",
     "productSlugs": ["azure"],
     "disableDocsMs": true,
-    "apiRefLink": "https://docs.microsoft.com/javascript/api/@msinternal/compute-resource-manager?view=azure-node-preview"
+    "apiRefLink": "https://learn.microsoft.com/javascript/api/@msinternal/compute-resource-manager?view=azure-node-preview"
   }
 }
diff --git a/packages/autorest.typescript/test/smoke/generated/keyvault-resource-manager/package.json b/packages/autorest.typescript/test/smoke/generated/keyvault-resource-manager/package.json
@@ -102,6 +102,6 @@
     "productName": "",
     "productSlugs": ["azure"],
     "disableDocsMs": true,
-    "apiRefLink": "https://docs.microsoft.com/javascript/api/@msinternal/keyvault-resource-manager?view=azure-node-preview"
+    "apiRefLink": "https://learn.microsoft.com/javascript/api/@msinternal/keyvault-resource-manager?view=azure-node-preview"
   }
 }
diff --git a/packages/autorest.typescript/test/smoke/generated/msi-resource-manager/package.json b/packages/autorest.typescript/test/smoke/generated/msi-resource-manager/package.json
@@ -103,6 +103,6 @@
     "productName": "",
     "productSlugs": ["azure"],
     "disableDocsMs": true,
-    "apiRefLink": "https://docs.microsoft.com/javascript/api/@msinternal/msi-resource-manager?view=azure-node-preview"
+    "apiRefLink": "https://learn.microsoft.com/javascript/api/@msinternal/msi-resource-manager?view=azure-node-preview"
   }
 }
diff --git a/packages/autorest.typescript/test/smoke/generated/network-resource-manager/package.json b/packages/autorest.typescript/test/smoke/generated/network-resource-manager/package.json
@@ -102,6 +102,6 @@
     "productName": "",
     "productSlugs": ["azure"],
     "disableDocsMs": true,
-    "apiRefLink": "https://docs.microsoft.com/javascript/api/@msinternal/network-resource-manager?view=azure-node-preview"
+    "apiRefLink": "https://learn.microsoft.com/javascript/api/@msinternal/network-resource-manager?view=azure-node-preview"
   }
 }
diff --git a/packages/autorest.typescript/test/smoke/generated/sql-resource-manager/package.json b/packages/autorest.typescript/test/smoke/generated/sql-resource-manager/package.json
@@ -102,6 +102,6 @@
     "productName": "",
     "productSlugs": ["azure"],
     "disableDocsMs": true,
-    "apiRefLink": "https://docs.microsoft.com/javascript/api/@msinternal/sql-resource-manager?view=azure-node-preview"
+    "apiRefLink": "https://learn.microsoft.com/javascript/api/@msinternal/sql-resource-manager?view=azure-node-preview"
   }
 }
diff --git a/packages/autorest.typescript/test/smoke/generated/storage-resource-manager/package.json b/packages/autorest.typescript/test/smoke/generated/storage-resource-manager/package.json
@@ -102,6 +102,6 @@
     "productName": "",
     "productSlugs": ["azure"],
     "disableDocsMs": true,
-    "apiRefLink": "https://docs.microsoft.com/javascript/api/@msinternal/storage-resource-manager?view=azure-node-preview"
+    "apiRefLink": "https://learn.microsoft.com/javascript/api/@msinternal/storage-resource-manager?view=azure-node-preview"
   }
 }
diff --git a/packages/autorest.typescript/test/smoke/generated/web-resource-manager/package.json b/packages/autorest.typescript/test/smoke/generated/web-resource-manager/package.json
@@ -102,6 +102,6 @@
     "productName": "",
     "productSlugs": ["azure"],
     "disableDocsMs": true,
-    "apiRefLink": "https://docs.microsoft.com/javascript/api/@msinternal/web-resource-manager?view=azure-node-preview"
+    "apiRefLink": "https://learn.microsoft.com/javascript/api/@msinternal/web-resource-manager?view=azure-node-preview"
   }
 }
diff --git a/packages/autorest.typescript/test/unit/generators/static/files/case-hlcReadme-without-subid.md b/packages/autorest.typescript/test/unit/generators/static/files/case-hlcReadme-without-subid.md
@@ -6,7 +6,7 @@ The Azure Kusto management API provides a RESTful set of web services that inter
 
 [Source code](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/kusto/arm-kusto) |
 [Package (NPM)](https://www.npmjs.com/package/@azure/arm-kusto) |
-[API reference documentation](https://docs.microsoft.com/javascript/api/@azure/arm-kusto?view=azure-node-preview) |
+[API reference documentation](https://learn.microsoft.com/javascript/api/@azure/arm-kusto?view=azure-node-preview) |
 [Samples](https://github.com/Azure-Samples/azure-samples-js-management)
 
 ## Getting started
@@ -45,7 +45,7 @@ npm install @azure/identity
 
 You will also need to **register a new AAD application and grant access to Azure KustoManagement** by assigning the suitable role to your service principal (note: roles such as `"Owner"` will not grant the necessary permissions).
 
-For more information about how to create an Azure AD Application check out [this guide](https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal).
+For more information about how to create an Azure AD Application check out [this guide](https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal).
 
 ```javascript
 const { KustoManagementClient } = require("@azure/arm-kusto");
@@ -99,7 +99,7 @@ If you'd like to contribute to this library, please read the [contributing guide
 
 ![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-js%2Fsdk%2Fkusto%2Farm-kusto%2FREADME.png)
 
-[azure_cli]: https://docs.microsoft.com/cli/azure
+[azure_cli]: https://learn.microsoft.com/cli/azure
 [azure_sub]: https://azure.microsoft.com/free/
 [azure_sub]: https://azure.microsoft.com/free/
 [azure_portal]: https://portal.azure.com
diff --git a/packages/autorest.typescript/test/unit/generators/static/files/case-hlcReadme.md b/packages/autorest.typescript/test/unit/generators/static/files/case-hlcReadme.md
@@ -6,7 +6,7 @@ The Azure Kusto management API provides a RESTful set of web services that inter
 
 [Source code](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/kusto/arm-kusto) |
 [Package (NPM)](https://www.npmjs.com/package/@azure/arm-kusto) |
-[API reference documentation](https://docs.microsoft.com/javascript/api/@azure/arm-kusto?view=azure-node-preview) |
+[API reference documentation](https://learn.microsoft.com/javascript/api/@azure/arm-kusto?view=azure-node-preview) |
 [Samples](https://github.com/Azure-Samples/azure-samples-js-management)
 
 ## Getting started
@@ -45,7 +45,7 @@ npm install @azure/identity
 
 You will also need to **register a new AAD application and grant access to Azure KustoManagement** by assigning the suitable role to your service principal (note: roles such as `"Owner"` will not grant the necessary permissions).
 
-For more information about how to create an Azure AD Application check out [this guide](https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal).
+For more information about how to create an Azure AD Application check out [this guide](https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal).
 
 ```javascript
 const { KustoManagementClient } = require("@azure/arm-kusto");
@@ -100,7 +100,7 @@ If you'd like to contribute to this library, please read the [contributing guide
 
 ![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-js%2Fsdk%2Fkusto%2Farm-kusto%2FREADME.png)
 
-[azure_cli]: https://docs.microsoft.com/cli/azure
+[azure_cli]: https://learn.microsoft.com/cli/azure
 [azure_sub]: https://azure.microsoft.com/free/
 [azure_sub]: https://azure.microsoft.com/free/
 [azure_portal]: https://portal.azure.com
diff --git a/packages/autorest.typescript/test/unit/restLevelClient/files/case-rlcReadme.md b/packages/autorest.typescript/test/unit/restLevelClient/files/case-rlcReadme.md
@@ -8,7 +8,7 @@ Key links:
 
 - [Source code](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/agrifood/agrifood-farming-rest)
 - [Package (NPM)](https://www.npmjs.com/package/@azure-rest/agrifood-farming)
-- [API reference documentation](https://docs.microsoft.com/javascript/api/@azure-rest/agrifood-farming?view=azure-node-preview)
+- [API reference documentation](https://learn.microsoft.com/javascript/api/@azure-rest/agrifood-farming?view=azure-node-preview)
 - [Product documentation](https://azure.microsoft.com/en-us/services/purview/)
 
 ## Getting started
@@ -19,7 +19,7 @@ Key links:
 
 ### Prerequisites
 
-- You must have an [Azure subscription](https://azure.microsoft.com/free/) and follow [these](https://docs.microsoft.com/en-us/azure/purview/create-catalog-portal#add-a-security-principal-to-a-data-plane-role) instructions to use this package.
+- You must have an [Azure subscription](https://azure.microsoft.com/free/) and follow [these](https://learn.microsoft.com/en-us/azure/purview/create-catalog-portal#add-a-security-principal-to-a-data-plane-role) instructions to use this package.
 
 ### Install the `@azure-rest/agrifood-farming` package
 
@@ -36,7 +36,7 @@ provide an instance of the desired credential type obtained from the
 [@azure/identity](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/identity/identity#credentials) library.
 
 To authenticate with AAD, you must first `npm` install [`@azure/identity`](https://www.npmjs.com/package/@azure/identity) and
-[enable AAD authentication on your Purview resource](https://docs.microsoft.com/en-us/azure/purview/create-catalog-portal#add-a-security-principal-to-a-data-plane-role)
+[enable AAD authentication on your Purview resource](https://learn.microsoft.com/en-us/azure/purview/create-catalog-portal#add-a-security-principal-to-a-data-plane-role)
 
 After setup, you can choose which type of [credential](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/identity/identity#credentials) from `@azure/identity` to use.
 As an example, [DefaultAzureCredential](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/identity/identity#defaultazurecredential)
diff --git a/packages/autorest.typescript/test/unit/restLevelClient/generateReadmeFile.spec.ts b/packages/autorest.typescript/test/unit/restLevelClient/generateReadmeFile.spec.ts
@@ -38,7 +38,7 @@ describe("generateReadmeFile", () => {
       productDocLink: "https://azure.microsoft.com/en-us/services/purview/",
       dependencyInfo: {
         link:
-          "https://docs.microsoft.com/en-us/azure/purview/create-catalog-portal#add-a-security-principal-to-a-data-plane-role",
+          "https://learn.microsoft.com/en-us/azure/purview/create-catalog-portal#add-a-security-principal-to-a-data-plane-role",
         description: "enable AAD authentication on your Purview resource"
       }
     } as autorestSession.AutorestOptions;
diff --git a/packages/rlc-common/src/metadata/buildReadmeFile.ts b/packages/rlc-common/src/metadata/buildReadmeFile.ts
@@ -146,7 +146,7 @@ npm install @azure/identity
 
 You will also need to **register a new AAD application and grant access to {{ serviceName}}** by assigning the suitable role to your service principal (note: roles such as \`"Owner"\` will not grant the necessary permissions).
 
-For more information about how to create an Azure AD Application check out [this guide](https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal).
+For more information about how to create an Azure AD Application check out [this guide](https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal).
 
 {{#if azureArm}}
 \`\`\`javascript
@@ -381,7 +381,7 @@ function createMetadata(model: RLCModel): Metadata | undefined {
         ? `${packageSourceURL}/samples`
         : undefined,
     apiRefURL: azureHuh
-      ? `https://docs.microsoft.com/javascript/api/${clientPackageName}${apiRefUrlQueryParameter}`
+      ? `https://learn.microsoft.com/javascript/api/${clientPackageName}${apiRefUrlQueryParameter}`
       : undefined,
     dependencyDescription: dependencyInfo?.description,
     dependencyLink: dependencyInfo?.link,
diff --git a/packages/rlc-common/src/metadata/packageJson/buildAzureMonorepoPackage.ts b/packages/rlc-common/src/metadata/packageJson/buildAzureMonorepoPackage.ts
@@ -97,7 +97,7 @@ function getSampleMetadata({
       productName: name,
       productSlugs: ["azure"],
       disableDocsMs: true,
-      apiRefLink: `https://docs.microsoft.com/javascript/api/${name}${apiRefUrlQueryParameter}`
+      apiRefLink: `https://learn.microsoft.com/javascript/api/${name}${apiRefUrlQueryParameter}`
     }
   };
 }
diff --git a/packages/rlc-common/test/integration/packageJson.spec.ts b/packages/rlc-common/test/integration/packageJson.spec.ts
@@ -178,7 +178,7 @@ describe("Package file generation", () => {
         productName: `${libraryName}`,
         productSlugs: ["azure"],
         disableDocsMs: true,
-        apiRefLink: `https://docs.microsoft.com/javascript/api/${libraryName}`
+        apiRefLink: `https://learn.microsoft.com/javascript/api/${libraryName}`
       };
 
       expect(packageFile).to.have.property("//sampleConfiguration");
@@ -200,7 +200,7 @@ describe("Package file generation", () => {
         productName: `${libraryName}`,
         productSlugs: ["azure"],
         disableDocsMs: true,
-        apiRefLink: `https://docs.microsoft.com/javascript/api/${libraryName}?view=azure-node-preview`
+        apiRefLink: `https://learn.microsoft.com/javascript/api/${libraryName}?view=azure-node-preview`
       };
 
       expect(packageFile).to.have.property("//sampleConfiguration");
diff --git a/packages/typespec-test/test/NetworkAnalytics.Management/generated/typespec-ts/sdk/test/arm-test/README.md b/packages/typespec-test/test/NetworkAnalytics.Management/generated/typespec-ts/sdk/test/arm-test/README.md
@@ -8,7 +8,7 @@ Key links:
 
 - [Source code](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/test/arm-test)
 - [Package (NPM)](https://www.npmjs.com/package/@azure/arm-networkanalytics)
-- [API reference documentation](https://docs.microsoft.com/javascript/api/@azure/arm-networkanalytics?view=azure-node-preview)
+- [API reference documentation](https://learn.microsoft.com/javascript/api/@azure/arm-networkanalytics?view=azure-node-preview)
 - [Samples](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/test/arm-test/samples)
 
 ## Getting started
@@ -47,7 +47,7 @@ npm install @azure/identity
 
 You will also need to **register a new AAD application and grant access to Azure NetworkAnalytics** by assigning the suitable role to your service principal (note: roles such as `"Owner"` will not grant the necessary permissions).
 
-For more information about how to create an Azure AD Application check out [this guide](https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal).
+For more information about how to create an Azure AD Application check out [this guide](https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal).
 
 ```javascript
 const { NetworkAnalyticsClient } = require("@azure/arm-networkanalytics");
diff --git a/packages/typespec-test/test/ai/generated/typespec-ts/README.md b/packages/typespec-test/test/ai/generated/typespec-ts/README.md
@@ -7,7 +7,7 @@ This package contains an isomorphic SDK (runs both in Node.js and in browsers) f
 Key links:
 
 - [Package (NPM)](https://www.npmjs.com/package/@azure/ai-client)
-- [API reference documentation](https://docs.microsoft.com/javascript/api/@azure/ai-client?view=azure-node-preview)
+- [API reference documentation](https://learn.microsoft.com/javascript/api/@azure/ai-client?view=azure-node-preview)
 
 ## Getting started
 
@@ -45,7 +45,7 @@ npm install @azure/identity
 
 You will also need to **register a new AAD application and grant access to Azure Client** by assigning the suitable role to your service principal (note: roles such as `"Owner"` will not grant the necessary permissions).
 
-For more information about how to create an Azure AD Application check out [this guide](https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal).
+For more information about how to create an Azure AD Application check out [this guide](https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal).
 
 ```javascript
 const { ClientClient } = require("@azure/ai-client");
diff --git a/packages/typespec-test/test/batch_modular/generated/typespec-ts/README.md b/packages/typespec-test/test/batch_modular/generated/typespec-ts/README.md
@@ -7,7 +7,7 @@ Azure Batch provides Cloud-scale job scheduling and compute management.
 Key links:
 
 - [Package (NPM)](https://www.npmjs.com/package/@azure-rest/batch)
-- [API reference documentation](https://docs.microsoft.com/javascript/api/@azure-rest/batch?view=azure-node-preview)
+- [API reference documentation](https://learn.microsoft.com/javascript/api/@azure-rest/batch?view=azure-node-preview)
 
 ## Getting started
 
@@ -45,7 +45,7 @@ npm install @azure/identity
 
 You will also need to **register a new AAD application and grant access to Azure Batch** by assigning the suitable role to your service principal (note: roles such as `"Owner"` will not grant the necessary permissions).
 
-For more information about how to create an Azure AD Application check out [this guide](https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal).
+For more information about how to create an Azure AD Application check out [this guide](https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal).
 
 ```javascript
 const { BatchClient } = require("@azure-rest/batch");
diff --git a/packages/typespec-test/test/chatApi_modular/generated/typespec-ts/README.md b/packages/typespec-test/test/chatApi_modular/generated/typespec-ts/README.md
@@ -7,7 +7,7 @@ Azure APIs for the Azure Chat protocol.
 Key links:
 
 - [Package (NPM)](https://www.npmjs.com/package/@azure/ai-chat-protocol)
-- [API reference documentation](https://docs.microsoft.com/javascript/api/@azure/ai-chat-protocol?view=azure-node-preview)
+- [API reference documentation](https://learn.microsoft.com/javascript/api/@azure/ai-chat-protocol?view=azure-node-preview)
 
 ## Getting started
 
@@ -45,7 +45,7 @@ npm install @azure/identity
 
 You will also need to **register a new AAD application and grant access to Azure ChatProtocol** by assigning the suitable role to your service principal (note: roles such as `"Owner"` will not grant the necessary permissions).
 
-For more information about how to create an Azure AD Application check out [this guide](https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal).
+For more information about how to create an Azure AD Application check out [this guide](https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal).
 
 ```javascript
 const { ChatProtocolClient } = require("@azure/ai-chat-protocol");
diff --git a/packages/typespec-test/test/contentsafety_modular/generated/typespec-ts/README.md b/packages/typespec-test/test/contentsafety_modular/generated/typespec-ts/README.md
@@ -7,7 +7,7 @@ Analyze harmful content
 Key links:
 
 - [Package (NPM)](https://www.npmjs.com/package/@azure-rest/ai-content-safety)
-- [API reference documentation](https://docs.microsoft.com/javascript/api/@azure-rest/ai-content-safety)
+- [API reference documentation](https://learn.microsoft.com/javascript/api/@azure-rest/ai-content-safety)
 
 ## Getting started
 
@@ -45,7 +45,7 @@ npm install @azure/identity
 
 You will also need to **register a new AAD application and grant access to Azure ContentSafety** by assigning the suitable role to your service principal (note: roles such as `"Owner"` will not grant the necessary permissions).
 
-For more information about how to create an Azure AD Application check out [this guide](https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal).
+For more information about how to create an Azure AD Application check out [this guide](https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal).
 
 ```javascript
 const { ContentSafetyClient } = require("@azure-rest/ai-content-safety");
diff --git a/packages/typespec-test/test/contoso/generated/typespec-ts/README.md b/packages/typespec-test/test/contoso/generated/typespec-ts/README.md
@@ -7,7 +7,7 @@ Contoso WidgetManager Service
 Key links:
 
 - [Package (NPM)](https://www.npmjs.com/package/@azure-rest/contosowidgetmanager-rest)
-- [API reference documentation](https://docs.microsoft.com/javascript/api/@azure-rest/contosowidgetmanager-rest?view=azure-node-preview)
+- [API reference documentation](https://learn.microsoft.com/javascript/api/@azure-rest/contosowidgetmanager-rest?view=azure-node-preview)
 
 ## Getting started
 
diff --git a/packages/typespec-test/test/faceai/generated/typespec-ts/README.md b/packages/typespec-test/test/faceai/generated/typespec-ts/README.md
diff --git a/packages/typespec-test/test/healthInsights_radiologyinsights/generated/typespec-ts/README.md b/packages/typespec-test/test/healthInsights_radiologyinsights/generated/typespec-ts/README.md
diff --git a/packages/typespec-test/test/healthInsights_trialmatcher/generated/typespec-ts/README.md b/packages/typespec-test/test/healthInsights_trialmatcher/generated/typespec-ts/README.md
diff --git a/packages/typespec-test/test/loadTest/generated/typespec-ts/README.md b/packages/typespec-test/test/loadTest/generated/typespec-ts/README.md
diff --git a/packages/typespec-test/test/loadtesting_modular/generated/typespec-ts/README.md b/packages/typespec-test/test/loadtesting_modular/generated/typespec-ts/README.md
diff --git a/packages/typespec-test/test/translator/generated/typespec-ts/README.md b/packages/typespec-test/test/translator/generated/typespec-ts/README.md

Original file line number	Diff line number	Diff line change
`@@ -238,7 +238,7 @@ function regularAutorestPackage(`
`238`	`238`	`productName: description,`
`239`	`239`	`productSlugs: ["azure"],`
`240`	`240`	`disableDocsMs: true,`
`241`		- apiRefLink: `https://docs.microsoft.com/javascript/api/${clientPackageName}${apiRefUrlQueryParameter}`
	`241`	+ apiRefLink: `https://learn.microsoft.com/javascript/api/${clientPackageName}${apiRefUrlQueryParameter}`
`242`	`242`	`};`
`243`	`243`	`}`
`244`	`244`	`return packageInfo;`
Original file line number	Diff line number	Diff line change
`@@ -87,6 +87,6 @@`
`87`	`87`	`"productName": "@msinternal/dpg-customization-rest",`
`88`	`88`	`"productSlugs": ["azure"],`
`89`	`89`	`"disableDocsMs": true,`
`90`		`- "apiRefLink": "https://docs.microsoft.com/javascript/api/@msinternal/dpg-customization-rest"`
	`90`	`+ "apiRefLink": "https://learn.microsoft.com/javascript/api/@msinternal/dpg-customization-rest"`
`91`	`91`	`}`
`92`	`92`	`}`
Original file line number	Diff line number	Diff line change
`@@ -100,6 +100,6 @@`
`100`	`100`	`"productName": "",`
`101`	`101`	`"productSlugs": ["azure"],`
`102`	`102`	`"disableDocsMs": true,`
`103`		`- "apiRefLink": "https://docs.microsoft.com/javascript/api/@msinternal/arm-package-subscriptions-2019-06?view=azure-node-preview"`
	`103`	`+ "apiRefLink": "https://learn.microsoft.com/javascript/api/@msinternal/arm-package-subscriptions-2019-06?view=azure-node-preview"`
`104`	`104`	`}`
`105`	`105`	`}`
Original file line number	Diff line number	Diff line change
`@@ -102,6 +102,6 @@`
`102`	`102`	`"productName": "",`
`103`	`103`	`"productSlugs": ["azure"],`
`104`	`104`	`"disableDocsMs": true,`
`105`		`- "apiRefLink": "https://docs.microsoft.com/javascript/api/@msinternal/compute-resource-manager?view=azure-node-preview"`
	`105`	`+ "apiRefLink": "https://learn.microsoft.com/javascript/api/@msinternal/compute-resource-manager?view=azure-node-preview"`
`106`	`106`	`}`
`107`	`107`	`}`
Original file line number	Diff line number	Diff line change
`@@ -103,6 +103,6 @@`
`103`	`103`	`"productName": "",`
`104`	`104`	`"productSlugs": ["azure"],`
`105`	`105`	`"disableDocsMs": true,`
`106`		`- "apiRefLink": "https://docs.microsoft.com/javascript/api/@msinternal/msi-resource-manager?view=azure-node-preview"`
	`106`	`+ "apiRefLink": "https://learn.microsoft.com/javascript/api/@msinternal/msi-resource-manager?view=azure-node-preview"`
`107`	`107`	`}`
`108`	`108`	`}`