improvements: address feedback

docs/documentation/platform/secret-rotation/auth0-client-secret.mdx

@@ -13,11 +13,7 @@ description: "Learn how to automatically rotate Auth0 Client Secrets."
 
 ## Prerequisites
 
-1. Create an [Auth0 Connection](/integrations/app-connections/auth0) with the required **Secret Rotation** audience and permissions
-2. Copy the **Client ID** of the application in Auth0 you want to rotate the Client Secret for:
-
-   ![Auth0 Client ID](/images/secret-rotations-v2/auth0-client-secret/auth0-app-client-id.png)
-
+- Create an [Auth0 Connection](/integrations/app-connections/auth0) with the required **Secret Rotation** audience and permissions
 
 ## Create an Auth0 Client Secret Rotation in Infisical
 
@@ -36,12 +32,14 @@ description: "Learn how to automatically rotate Auth0 Client Secrets."
             - **Rotation Interval** - the interval, in days, that once elapsed will trigger a rotation.
             - **Rotate At** - the local time of day when rotation should occur once the interval has elapsed.
             - **Auto-Rotation Enabled** - whether secrets should automatically be rotated once the rotation interval has elapsed. Disable this option to manually rotate secrets or pause secret rotation.
+            <Note>
+                Due to Auth0 Client Secret Rotations rotating a single credential set, auto-rotation may result in service interruptions. If you need to ensure service continuity, we recommend disabling this option.
+            </Note>
 
-        4. Input the Client ID of the Auth0 application acquired above that will have its Client Secret rotated. Then click **Next**.
+
+        4. Select the Auth0 application whose Client Secret you want to rotate. Then click **Next**.
         ![Rotation Parameters](/images/secret-rotations-v2/auth0-client-secret/auth0-client-secret-parameters.png)
 
-            - **Client ID** - the Client ID of the application whose Client Secret will be rotated.
-
         5. Specify the secret names that the client credentials should be mapped to. Then click **Next**.
         ![Rotation Secrets Mapping](/images/secret-rotations-v2/auth0-client-secret/auth0-client-secret-secrets-mapping.png)
 
@@ -64,6 +62,10 @@ description: "Learn how to automatically rotate Auth0 Client Secrets."
         To create an Auth0 Client Secret Rotation, make an API request to the [Create Auth0
         Client Secret Rotation](/api-reference/endpoints/secret-rotations/auth0-client-secret/create) API endpoint.
 
+        You will first need the **Client ID** of the Auth0 application you want to rotate the secret for. This can be obtained from the Applications dashboard.
+        ![Auth0 Client ID](/images/secret-rotations-v2/auth0-client-secret/auth0-app-client-id.png)
+
+
         ### Sample request
 
         ```bash Request
@@ -71,9 +73,9 @@ description: "Learn how to automatically rotate Auth0 Client Secrets."
         --url https://us.infisical.com/api/v2/secret-rotations/auth0-client-secret \
         --header 'Content-Type: application/json' \
         --data '{
-            "name": "my-pg-rotation",
+            "name": "my-auth0-rotation",
             "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
-            "description": "my database credentials rotation",
+            "description": "my client secret rotation",
             "connectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
             "environment": "dev",
             "secretPath": "/",
@@ -93,14 +95,18 @@ description: "Learn how to automatically rotate Auth0 Client Secrets."
         }'
         ```
 
+        <Note>
+            Due to Auth0 Client Secret Rotations rotating a single credential set, auto-rotation may result in service interruptions. If you need to ensure service continuity, we recommend disabling this option.
+        </Note>
+
         ### Sample response
 
         ```bash Response
         {
             "secretRotation": {
                 "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
-                "name": "my-pg-rotation",
-                "description": "my database credentials rotation",
+                "name": "my-auth0-rotation",
+                "description": "my client secret rotation",
                 "secretsMapping": {
                     "clientId": "AUTH0_CLIENT_ID",
                     "clientSecret": "AUTH0_CLIENT_SECRET"

docs/integrations/app-connections/auth0.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Auth0 Connection"
-description: "Learn how to configure a Auth0 Connection for Infisical."
+description: "Learn how to configure an Auth0 Connection for Infisical."
 ---
 
 Infisical supports the use of [Client Credentials](https://auth0.com/docs/get-started/authentication-and-authorization-flow/client-credentials-flow) to connect with your Auth0 applications.
@@ -22,7 +22,7 @@ Infisical supports the use of [Client Credentials](https://auth0.com/docs/get-st
 
         <Tabs>
             <Tab title="Secret Rotation">
-                Select the **Auth0 Management API** option from the dropdown and grant the `update:client_keys` permission.
+                Select the **Auth0 Management API** option from the dropdown and grant the `update:client_keys` and `read:clients` permission.
                 ![Secret Rotation Authorization](/images/app-connections/auth0/auth0-secret-rotation-api-selection.png)
             </Tab>
         </Tabs>
@@ -72,7 +72,7 @@ Infisical supports the use of [Client Credentials](https://auth0.com/docs/get-st
                 "clientId": "...",
                 "clientSecret": "...",
                 "audience": "https://xxx-xxxxxxxxx.us.auth0.com/api/v2/"
-            },
+            }
         }'
         ```