From 99a003f81a99dade00025b5372683d072146622b Mon Sep 17 00:00:00 2001
From: Archana Iddya <archidda@microsoft.com>
Date: Mon, 1 Jun 2026 11:43:27 -0700
Subject: [PATCH 1/2] Use aka.ms install links and Bash/PowerShell doc sections

Replace raw.githubusercontent.com installer URLs with the aka.ms short links (https://aka.ms/connector-namespace-cli-install for Bash, https://aka.ms/connector-namespace-cli-install-ps for PowerShell) and rename the OS-based 'Linux / macOS' and 'Windows (PowerShell)' install sections to shell-based 'Bash' and 'PowerShell' sections. Also updates the usage-comment headers in install.sh and install.ps1.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 .../connector-namespace-cli/README.md         | 21 +++++++++----------
 .../complete-reference.md                     | 21 +++++++++----------
 .../connector-namespace-cli/install.ps1       |  6 +++---
 .../connector-namespace-cli/install.sh        |  6 +++---
 4 files changed, 26 insertions(+), 28 deletions(-)

diff --git a/public-preview/connector-namespace-cli/README.md b/public-preview/connector-namespace-cli/README.md
index 1f6fc49..eecba9a 100644
--- a/public-preview/connector-namespace-cli/README.md
+++ b/public-preview/connector-namespace-cli/README.md
@@ -14,41 +14,40 @@ Manage **`Microsoft.Web/connectorGateways`** (Connector Namespaces) and their ch
 
 ## Installation
 
-### Linux / macOS
+### Bash
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/Azure/Connectors/main/public-preview/connector-namespace-cli/install.sh | sh
+curl -fsSL https://aka.ms/connector-namespace-cli-install | sh
 ```
 
 Pin a specific version:
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/Azure/Connectors/main/public-preview/connector-namespace-cli/install.sh \
-  | CONNECTOR_NAMESPACE_VERSION=1.0.0b9 sh
+curl -fsSL https://aka.ms/connector-namespace-cli-install | CONNECTOR_NAMESPACE_VERSION=1.0.0b9 sh
 ```
 
-### Windows (PowerShell)
+### PowerShell
 
 ```powershell
-irm https://raw.githubusercontent.com/Azure/Connectors/main/public-preview/connector-namespace-cli/install.ps1 | iex
+irm https://aka.ms/connector-namespace-cli-install-ps | iex
 ```
 
 Pin a specific version:
 
 ```powershell
-& ([scriptblock]::Create((irm https://raw.githubusercontent.com/Azure/Connectors/main/public-preview/connector-namespace-cli/install.ps1))) -Version 1.0.0b9
+& ([scriptblock]::Create((irm https://aka.ms/connector-namespace-cli-install-ps))) -Version 1.0.0b9
 ```
 
 ### Uninstall
 
 ```bash
-# Linux / macOS
-curl -fsSL https://raw.githubusercontent.com/Azure/Connectors/main/public-preview/connector-namespace-cli/install.sh | sh -s -- --uninstall
+# Bash
+curl -fsSL https://aka.ms/connector-namespace-cli-install | sh -s -- --uninstall
 ```
 
 ```powershell
-# Windows
-& ([scriptblock]::Create((irm https://raw.githubusercontent.com/Azure/Connectors/main/public-preview/connector-namespace-cli/install.ps1))) -Uninstall
+# PowerShell
+& ([scriptblock]::Create((irm https://aka.ms/connector-namespace-cli-install-ps))) -Uninstall
 ```
 
 ### Verify the install
diff --git a/public-preview/connector-namespace-cli/complete-reference.md b/public-preview/connector-namespace-cli/complete-reference.md
index 4715027..cdeb8dc 100644
--- a/public-preview/connector-namespace-cli/complete-reference.md
+++ b/public-preview/connector-namespace-cli/complete-reference.md
@@ -32,16 +32,16 @@ Reference documentation for the `connector-namespace` Azure CLI extension. Cover
 
 ## Installation
 
-### Linux / macOS
+### Bash
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/Azure/Connectors/main/public-preview/connector-namespace-cli/install.sh | sh
+curl -fsSL https://aka.ms/connector-namespace-cli-install | sh
 ```
 
-### Windows (PowerShell)
+### PowerShell
 
 ```powershell
-irm https://raw.githubusercontent.com/Azure/Connectors/main/public-preview/connector-namespace-cli/install.ps1 | iex
+irm https://aka.ms/connector-namespace-cli-install-ps | iex
 ```
 
 ### Version pinning
@@ -49,14 +49,13 @@ irm https://raw.githubusercontent.com/Azure/Connectors/main/public-preview/conne
 By default the installer scripts install whatever the [`https://aka.ms/connector-namespace.whl`](https://aka.ms/connector-namespace.whl) redirect currently points at (the latest published wheel). To install a different version explicitly:
 
 ```bash
-# Linux / macOS
-curl -fsSL https://raw.githubusercontent.com/Azure/Connectors/main/public-preview/connector-namespace-cli/install.sh \
-  | CONNECTOR_NAMESPACE_VERSION=1.0.0b9 sh
+# Bash
+curl -fsSL https://aka.ms/connector-namespace-cli-install | CONNECTOR_NAMESPACE_VERSION=1.0.0b9 sh
 ```
 
 ```powershell
-# Windows
-& ([scriptblock]::Create((irm https://raw.githubusercontent.com/Azure/Connectors/main/public-preview/connector-namespace-cli/install.ps1))) -Version 1.0.0b9
+# PowerShell
+& ([scriptblock]::Create((irm https://aka.ms/connector-namespace-cli-install-ps))) -Version 1.0.0b9
 ```
 
 ### Direct install (no scripts)
@@ -70,11 +69,11 @@ az extension add --upgrade --yes --source \
 ### Uninstall
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/Azure/Connectors/main/public-preview/connector-namespace-cli/install.sh | sh -s -- --uninstall
+curl -fsSL https://aka.ms/connector-namespace-cli-install | sh -s -- --uninstall
 ```
 
 ```powershell
-& ([scriptblock]::Create((irm https://raw.githubusercontent.com/Azure/Connectors/main/public-preview/connector-namespace-cli/install.ps1))) -Uninstall
+& ([scriptblock]::Create((irm https://aka.ms/connector-namespace-cli-install-ps))) -Uninstall
 ```
 
 ### Verify
diff --git a/public-preview/connector-namespace-cli/install.ps1 b/public-preview/connector-namespace-cli/install.ps1
index 3197738..0aebeda 100644
--- a/public-preview/connector-namespace-cli/install.ps1
+++ b/public-preview/connector-namespace-cli/install.ps1
@@ -2,13 +2,13 @@
 #
 # Usage:
 #   # Default: install the latest published wheel (https://aka.ms/connector-namespace.whl)
-#   irm https://raw.githubusercontent.com/Azure/Connectors/main/public-preview/connector-namespace-cli/install.ps1 | iex
+#   irm https://aka.ms/connector-namespace-cli-install-ps | iex
 #
 #   # Pin a different version:
-#   & ([scriptblock]::Create((irm https://raw.githubusercontent.com/Azure/Connectors/main/public-preview/connector-namespace-cli/install.ps1))) -Version 1.0.0b9
+#   & ([scriptblock]::Create((irm https://aka.ms/connector-namespace-cli-install-ps))) -Version 1.0.0b9
 #
 #   # Uninstall:
-#   & ([scriptblock]::Create((irm https://raw.githubusercontent.com/Azure/Connectors/main/public-preview/connector-namespace-cli/install.ps1))) -Uninstall
+#   & ([scriptblock]::Create((irm https://aka.ms/connector-namespace-cli-install-ps))) -Uninstall
 
 [CmdletBinding()]
 param(
diff --git a/public-preview/connector-namespace-cli/install.sh b/public-preview/connector-namespace-cli/install.sh
index 6a48170..f2ec2aa 100644
--- a/public-preview/connector-namespace-cli/install.sh
+++ b/public-preview/connector-namespace-cli/install.sh
@@ -3,14 +3,14 @@
 #
 # Usage:
 #   # Default: install the latest published wheel (https://aka.ms/connector-namespace.whl)
-#   curl -fsSL https://raw.githubusercontent.com/Azure/Connectors/main/public-preview/connector-namespace-cli/install.sh | sh
+#   curl -fsSL https://aka.ms/connector-namespace-cli-install | sh
 #
 #   # Pin a different version:
-#   curl -fsSL https://raw.githubusercontent.com/Azure/Connectors/main/public-preview/connector-namespace-cli/install.sh \
+#   curl -fsSL https://aka.ms/connector-namespace-cli-install \
 #     | CONNECTOR_NAMESPACE_VERSION=1.0.0b9 sh
 #
 #   # Uninstall:
-#   curl -fsSL https://raw.githubusercontent.com/Azure/Connectors/main/public-preview/connector-namespace-cli/install.sh \
+#   curl -fsSL https://aka.ms/connector-namespace-cli-install \
 #     | sh -s -- --uninstall
 
 set -eu

From 05392b96ff6536143e17fbad5ee6c61d732355db Mon Sep 17 00:00:00 2001
From: Archana Iddya <archidda@microsoft.com>
Date: Mon, 1 Jun 2026 11:46:27 -0700
Subject: [PATCH 2/2] Remove version-pinning install commands from CLI docs

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 public-preview/connector-namespace-cli/README.md   | 12 ------------
 .../connector-namespace-cli/complete-reference.md  | 14 --------------
 2 files changed, 26 deletions(-)

diff --git a/public-preview/connector-namespace-cli/README.md b/public-preview/connector-namespace-cli/README.md
index eecba9a..ed3f62a 100644
--- a/public-preview/connector-namespace-cli/README.md
+++ b/public-preview/connector-namespace-cli/README.md
@@ -20,24 +20,12 @@ Manage **`Microsoft.Web/connectorGateways`** (Connector Namespaces) and their ch
 curl -fsSL https://aka.ms/connector-namespace-cli-install | sh
 ```
 
-Pin a specific version:
-
-```bash
-curl -fsSL https://aka.ms/connector-namespace-cli-install | CONNECTOR_NAMESPACE_VERSION=1.0.0b9 sh
-```
-
 ### PowerShell
 
 ```powershell
 irm https://aka.ms/connector-namespace-cli-install-ps | iex
 ```
 
-Pin a specific version:
-
-```powershell
-& ([scriptblock]::Create((irm https://aka.ms/connector-namespace-cli-install-ps))) -Version 1.0.0b9
-```
-
 ### Uninstall
 
 ```bash
diff --git a/public-preview/connector-namespace-cli/complete-reference.md b/public-preview/connector-namespace-cli/complete-reference.md
index cdeb8dc..ce853ed 100644
--- a/public-preview/connector-namespace-cli/complete-reference.md
+++ b/public-preview/connector-namespace-cli/complete-reference.md
@@ -44,20 +44,6 @@ curl -fsSL https://aka.ms/connector-namespace-cli-install | sh
 irm https://aka.ms/connector-namespace-cli-install-ps | iex
 ```
 
-### Version pinning
-
-By default the installer scripts install whatever the [`https://aka.ms/connector-namespace.whl`](https://aka.ms/connector-namespace.whl) redirect currently points at (the latest published wheel). To install a different version explicitly:
-
-```bash
-# Bash
-curl -fsSL https://aka.ms/connector-namespace-cli-install | CONNECTOR_NAMESPACE_VERSION=1.0.0b9 sh
-```
-
-```powershell
-# PowerShell
-& ([scriptblock]::Create((irm https://aka.ms/connector-namespace-cli-install-ps))) -Version 1.0.0b9
-```
-
 ### Direct install (no scripts)
 
 ```bash