.Net & Python: Fix Broken Links (#5393)

### Description I used [link-inspector](https://github.com/justindhillon/link-inspector) to find and fix broken links in this project. This is an updated PR of #4910, which fixes the merge conflict. Here are the links I have fixed: https://docs.microsoft.com/rest/api/keyvault/getsecrets/getsecrets --> https://learn.microsoft.com/en-us/rest/api/keyvault/secrets/get-secret/get-secret https://docs.microsoft.com/rest/api/keyvault/getkeys/getkeys --> https://learn.microsoft.com/en-us/rest/api/keyvault/keys/get-keys/get-keys https://docs.microsoft.com/rest/api/keyvault/encrypt/encrypt --> https://learn.microsoft.com/en-us/rest/api/keyvault/keys/encrypt/encrypt https://docs.microsoft.com/rest/api/keyvault/decrypt/decrypt --> https://learn.microsoft.com/en-us/rest/api/keyvault/keys/decrypt/decrypt https://docs.microsoft.com/rest/api/keyvault/createkey/createkey --> https://learn.microsoft.com/en-us/rest/api/keyvault/keys/create-key/create-key https://docs.microsoft.com/rest/api/keyvault/getsecretversions/getsecretversions --> https://learn.microsoft.com/en-us/rest/api/keyvault/secrets/get-secret-versions/get-secret-versions https://github.com/microsoft/semantic-kernel/blob/main/python/semantic_kernel/planning/plan.py --> https://github.com/microsoft/semantic-kernel/blob/main/python/semantic_kernel/planners/plan.py https://github.com/microsoft/semantic-kernel/blob/main/python/semantic_kernel/planning/sequential_planner/Plugins/SequentialPlanning/skprompt.txt --> https://github.com/microsoft/semantic-kernel/blob/main/samples/plugins/QAPlugin/Form/skprompt.txt ### Support my work These links were found with [link-inspector](https://github.com/justindhillon/link-inspector). If you find this PR useful, give the repo a ⭐ ### Contribution Checklist  - [X] The code builds clean without any errors or warnings - [X] The PR follows the [SK Contribution Guidelines](https://github.com/microsoft/semantic-kernel/blob/main/CONTRIBUTING.md) and the [pre-submission formatting script](https://github.com/microsoft/semantic-kernel/blob/main/CONTRIBUTING.md#development-scripts) raises no violations - [X] All unit tests pass, and I have added new tests where possible - [X] I didn't break anyone 😄 --------- Co-authored-by: Stuart Morris <89403118+StuartMorrisHitachi@users.noreply.github.com> Co-authored-by: SergeyMenshykh <68852919+SergeyMenshykh@users.noreply.github.com> Co-authored-by: Mark Wallace <127216156+markwallace-microsoft@users.noreply.github.com> Co-authored-by: Roger Barreto <19890735+RogerBarreto@users.noreply.github.com> Co-authored-by: Jadyn <jadyn.wong@live.com> Co-authored-by: Evan Mattson <35585003+moonbox3@users.noreply.github.com> Co-authored-by: Chris <66376200+crickman@users.noreply.github.com> Co-authored-by: Eduard van Valkenburg <eavanvalkenburg@users.noreply.github.com>
microsoft · Mar 22, 2024 · a7d5bbf · a7d5bbf
1 parent f137bb7
commit a7d5bbf
Show file tree

Hide file tree

Showing 5 changed files with 17 additions and 17 deletions.
diff --git a/dotnet/samples/KernelSyntaxExamples/Resources/22-openapi.json b/dotnet/samples/KernelSyntaxExamples/Resources/22-openapi.json
@@ -12,7 +12,7 @@
   "paths": {
     "/keys": {
       "get": {
-        "description": "List keys in the specified vault.  For details, see https://docs.microsoft.com/rest/api/keyvault/getkeys/getkeys.",
+        "description": "List keys in the specified vault.  For details, see https://learn.microsoft.com/en-us/rest/api/keyvault/keys/get-keys/get-keys.",
         "operationId": "ListKey",
         "parameters": [
           {
@@ -86,7 +86,7 @@
     },
     "/keys/{key-name}": {
       "get": {
-        "description": "Gets the public part of a stored key. If the requested key is symmetric, then no key material is released in the response.  For more details, refer: https://docs.microsoft.com/rest/api/keyvault/getkey/getkey.",
+        "description": "Gets the public part of a stored key. If the requested key is symmetric, then no key material is released in the response.  For more details, refer: https://learn.microsoft.com/en-us/rest/api/keyvault/keys/get-key/get-key.",
         "operationId": "GetKey",
         "parameters": [
           {
@@ -186,7 +186,7 @@
     },
     "/keys/{key-name}/create": {
       "post": {
-        "description": "Creates a new key, stores it, then returns key parameters and attributes.  For details, see: https://docs.microsoft.com/rest/api/keyvault/createkey/createkey.",
+        "description": "Creates a new key, stores it, then returns key parameters and attributes.  For details, see: https://learn.microsoft.com/en-us/rest/api/keyvault/keys/create-key/create-key.",
         "operationId": "CreateKey",
         "parameters": [
           {
@@ -331,7 +331,7 @@
     },
     "/keys/{key-name}/decrypt": {
       "post": {
-        "description": "Decrypts a single block of encrypted data.  For details, see: https://docs.microsoft.com/rest/api/keyvault/decrypt/decrypt.",
+        "description": "Decrypts a single block of encrypted data.  For details, see: https://learn.microsoft.com/en-us/rest/api/keyvault/keys/decrypt/decrypt.",
         "operationId": "Decrypt",
         "parameters": [
           {
@@ -401,7 +401,7 @@
     },
     "/keys/{key-name}/encrypt": {
       "post": {
-        "description": "Encrypts an arbitrary sequence of bytes using an encryption key that is stored in a key vault.  For details, see: https://docs.microsoft.com/rest/api/keyvault/encrypt/encrypt.",
+        "description": "Encrypts an arbitrary sequence of bytes using an encryption key that is stored in a key vault.  For details, see: https://learn.microsoft.com/en-us/rest/api/keyvault/keys/encrypt/encrypt.",
         "operationId": "Encrypt",
         "parameters": [
           {
@@ -471,7 +471,7 @@
     },
     "/secrets": {
       "get": {
-        "description": "List secrets in a specified key vault.  For details, see: https://docs.microsoft.com/rest/api/keyvault/getsecrets/getsecrets.",
+        "description": "List secrets in a specified key vault.  For details, see: https://learn.microsoft.com/en-us/rest/api/keyvault/secrets/get-secret/get-secret.",
         "operationId": "ListSecret",
         "parameters": [
           {
@@ -547,7 +547,7 @@
     },
     "/secrets/{secret-name}": {
       "get": {
-        "description": "Get a specified secret from a given key vault. For details, see: https://docs.microsoft.com/rest/api/keyvault/getsecret/getsecret.",
+        "description": "Get a specified secret from a given key vault. For details, see: https://learn.microsoft.com/en-us/rest/api/keyvault/secrets/get-secret/get-secret.",
         "operationId": "GetSecret",
         "parameters": [
           {
@@ -611,7 +611,7 @@
         "summary": "Get secret"
       },
       "put": {
-        "description": "Sets a secret in a specified key vault. This operation adds a secret to the Azure Key Vault. If the named secret already exists, Azure Key Vault creates a new version of that secret. This operation requires the secrets/set permission. For details, see: https://docs.microsoft.com/rest/api/keyvault/setsecret/setsecret.",
+        "description": "Sets a secret in a specified key vault. This operation adds a secret to the Azure Key Vault. If the named secret already exists, Azure Key Vault creates a new version of that secret. This operation requires the secrets/set permission. For details, see: https://learn.microsoft.com/en-us/rest/api/keyvault/secrets/set-secret/set-secret.",
         "operationId": "SetSecret",
         "parameters": [
           {
@@ -703,7 +703,7 @@
     },
     "/secrets/{secret-name}/versions": {
       "get": {
-        "description": "List all versions of the specified secret.  For details, see: https://docs.microsoft.com/rest/api/keyvault/getsecretversions/getsecretversions.",
+        "description": "List all versions of the specified secret.  For details, see: https://learn.microsoft.com/en-us/rest/api/keyvault/secrets/get-secret-versions/get-secret-versions.",
         "operationId": "ListSecretVersions",
         "parameters": [
           {
@@ -773,7 +773,7 @@
     },
     "/secrets/{secret-name}/{secret-version}": {
       "get": {
-        "description": "Get the value of a specified secret version from a given key vault.  For details, see: https://docs.microsoft.com/rest/api/keyvault/getsecret/getsecret.",
+        "description": "Get the value of a specified secret version from a given key vault.  For details, see: https://learn.microsoft.com/en-us/rest/api/keyvault/secrets/get-secret/get-secret.",
         "operationId": "GetSecretVersion",
         "parameters": [
           {

diff --git a/dotnet/src/Functions/Functions.UnitTests/OpenApi/TestPlugins/documentV2_0.json b/dotnet/src/Functions/Functions.UnitTests/OpenApi/TestPlugins/documentV2_0.json
@@ -12,7 +12,7 @@
   "paths": {
     "/secrets/{secret-name}": {
       "get": {
-        "description": "Get a specified secret from a given key vault. For details, see: https://docs.microsoft.com/rest/api/keyvault/getsecret/getsecret.",
+        "description": "Get a specified secret from a given key vault. For details, see: https://learn.microsoft.com/en-us/rest/api/keyvault/secrets/get-secret/get-secret.",
         "operationId": "GetSecret",
         "parameters": [
           {

diff --git a/dotnet/src/Functions/Functions.UnitTests/OpenApi/TestPlugins/documentV3_0.json b/dotnet/src/Functions/Functions.UnitTests/OpenApi/TestPlugins/documentV3_0.json
@@ -14,7 +14,7 @@
     "/secrets/{secret-name}": {
       "get": {
         "summary": "Get secret",
-        "description": "Get a specified secret from a given key vault. For details, see: https://docs.microsoft.com/rest/api/keyvault/getsecret/getsecret.",
+        "description": "Get a specified secret from a given key vault. For details, see: https://learn.microsoft.com/en-us/rest/api/keyvault/secrets/get-secret/get-secret.",
         "operationId": "GetSecret",
         "parameters": [
           {
@@ -314,15 +314,15 @@
           "authorizationCode": {
             "authorizationUrl": "https://login.windows.net/common/oauth2/authorize",
             "tokenUrl": "https://login.windows.net/common/oauth2/authorize",
-            "scopes": { }
+            "scopes": {}
           }
         }
       }
     }
   },
   "security": [
     {
-      "oauth2_auth": [ ]
+      "oauth2_auth": []
     }
   ]
 }
diff --git a/dotnet/src/Functions/Functions.UnitTests/OpenApi/TestPlugins/documentV3_1.yaml b/dotnet/src/Functions/Functions.UnitTests/OpenApi/TestPlugins/documentV3_1.yaml
@@ -9,7 +9,7 @@ paths:
   '/secrets/{secret-name}':
     get:
       summary: Get secret
-      description: 'Get a specified secret from a given key vault. For details, see: https://docs.microsoft.com/rest/api/keyvault/getsecret/getsecret.'
+      description: 'Get a specified secret from a given key vault. For details, see: https://learn.microsoft.com/en-us/rest/api/keyvault/secrets/get-secret/get-secret.'
       operationId: GetSecret
       parameters:
         - name: secret-name

diff --git a/python/notebooks/05-using-the-planner.ipynb b/python/notebooks/05-using-the-planner.ipynb
@@ -341,7 +341,7 @@
    "source": [
     "To build more advanced planners, we need to introduce a proper Plan object that can contain all the necessary state and information needed for high quality plans.\n",
     "\n",
-    "To see what that object model is, look at (https://github.com/microsoft/semantic-kernel/blob/main/python/semantic_kernel/planning/plan.py)\n"
+    "To see what that object model is, look at (https://github.com/microsoft/semantic-kernel/blob/main/python/semantic_kernel/planners/plan.py)\n"
    ]
   },
   {
@@ -357,7 +357,7 @@
    "id": "a1c66d83",
    "metadata": {},
    "source": [
-    "The sequential planner is an XML-based step-by-step planner. You can see the prompt used for it here (https://github.com/microsoft/semantic-kernel/blob/main/python/semantic_kernel/planners/sequential_planner/Plugins/SequentialPlanning/skprompt.txt))\n"
+    "The sequential planner is an XML-based step-by-step planner. You can see the prompt used for it here (https://github.com/microsoft/semantic-kernel/blob/main/python/semantic_kernel/planners/sequential_planner/Plugins/SequentialPlanning/skprompt.txt)\n"
    ]
   },
   {