docs: Improve troubleshooting instructions

rancher · Jan 8, 2025 · e5176e0 · e5176e0
1 parent 4dd65ee
commit e5176e0
Show file tree

Hide file tree

Showing 3 changed files with 17 additions and 9 deletions.
diff --git a/...-user-guides/kubernetes-clusters-in-rancher-setup/register-existing-clusters.md b/...-user-guides/kubernetes-clusters-in-rancher-setup/register-existing-clusters.md
@@ -291,13 +291,15 @@ To annotate a registered cluster,
 
 ## Troubleshooting
 
-This section lists some of the most common errors that may occur when importing a cluster, along with steps to troubleshoot them.
+This section lists some of the most common errors that may occur when importing a cluster and provides steps to troubleshoot them.
 
 ### AKS
 
-- The following error  may occur if local accounts are disabled in your cluster.
+- The following error may occur if local accounts are disabled in your cluster.
   ```sh
   Error: Getting static credential is not allowed because this cluster is set to disable local accounts.
+  ```
+
   To resolve this issue, enable local accounts before attempting to [import the cluster](#registering-a-cluster) again.
 
     ```sh

diff --git a/...-user-guides/kubernetes-clusters-in-rancher-setup/register-existing-clusters.md b/...-user-guides/kubernetes-clusters-in-rancher-setup/register-existing-clusters.md
@@ -295,10 +295,13 @@ This section lists some of the most common errors that may occur when importing
 
 ### AKS
 
-#### Error: Getting static credential is not allowed because this cluster is set to disable local accounts.
+- The following error may occur if local accounts are disabled in your cluster.
+  ```sh
+  Error: Getting static credential is not allowed because this cluster is set to disable local accounts.
+  ```
 
-* This may occur if your cluster has disabled local accounts. Enable local accounts before attempting to import the cluster again:
+  To resolve this issue, enable local accounts before attempting to [import the cluster](#registering-a-cluster) again.
 
-  ```
+  ```sh
   az aks update --resource-group <resource-group> --name <cluster-name> --enable-local-accounts
   ```
diff --git a/...-user-guides/kubernetes-clusters-in-rancher-setup/register-existing-clusters.md b/...-user-guides/kubernetes-clusters-in-rancher-setup/register-existing-clusters.md
@@ -291,14 +291,17 @@ To annotate a registered cluster,
 
 ## Troubleshooting
 
-This section lists some of the most common errors that may occur when importing a cluster, along with steps to troubleshoot them.
+This section lists some of the most common errors that may occur when importing a cluster and provides steps to troubleshoot them.
 
 ### AKS
 
-#### Error: Getting static credential is not allowed because this cluster is set to disable local accounts.
+- The following error may occur if local accounts are disabled in your cluster.
+  ```sh
+  Error: Getting static credential is not allowed because this cluster is set to disable local accounts. 
+  ```
 
-* This may occur if your cluster has disabled local accounts. Enable local accounts before attempting to import the cluster again:
+  To resolve this issue, enable local accounts before attempting to [import the cluster](#registering-a-cluster) again.
 
-  ```
+  ```sh
   az aks update --resource-group <resource-group> --name <cluster-name> --enable-local-accounts
   ```