Merge pull request #18235 from uc4w6c/doc/improve_secret_manager

doc: improve secret manager settings

docs/my-website/docs/secret_managers/hashicorp_vault.md

@@ -198,10 +198,13 @@ LiteLLM stores secret under the `prefix_for_stored_virtual_keys` path (default:
 
 <Image img={require('../../img/hcorp_virtual_key.png')} />
 
-### Team-specific overrides (proxy)
+### Team-specific overrides
 
-When running the LiteLLM proxy you can override the Vault location per team. Set
-`Secret Manager Settings` on the team with the following structure:
+When running the LiteLLM proxy you can override the Vault location per team. Use the [Team-Level Secret Manager Settings](./overview.md#team-level-secret-manager-settings) flow in the dashboard and configure the panel shown below:
+
+<Image img={require('../../img/secret_manager_hashicorp_vault_settings.png')} />
+
+Use the following structure for the JSON payload:
 
 ```json
 {

docs/my-website/docs/secret_managers/overview.md

@@ -49,9 +49,28 @@ general_settings:
 
 ## Team-Level Secret Manager Settings
 
-From the **Teams** page in the LiteLLM dashboard you can configure a secret manager per team. Open the team (or the “Create New Team” modal), find the **Secret Manager Settings** panel, and enter the provider-specific JSON configuration (e.g. `{"namespace": "admin", "mount": "secret", "path_prefix": "litellm"}`). This configuration is applied whenever LiteLLM writes secrets (e.g., storing virtual keys) on behalf of that team.
+Team-level secret manager settings let every team bring their own key-management configuration. These settings are used when creating virtual keys tied to the team.
 
-<Image img={require('../../img/secret_manager_settings.png')} />
+Follow these steps to configure it:
 
+1. **Create a team**  
+   Open the Teams page and click `Create Team` to launch the modal.  
 
-Refer to each provider’s documentation (AWS, Azure, Google, Hashicorp, etc.) for the supported keys/values you can place inside `secret_manager_settings`.
+   <Image img={require('../../img/secret_manager_settings_create_team.png')} />
+
+2. **Expand Additional Settings**  
+   Use the `Additional Settings` toggle to reveal the advanced configuration panel.  
+   
+  <Image img={require('../../img/secret_manager_settings_additional_settings.png')} />
+
+3. **Configure the Secret Manager**  
+   In the `Secret Manager Settings` panel, paste the provider-specific JSON. Refer to each provider page (AWS, Azure, Google, Hashicorp, etc.) for the supported keys/values. JSON is required today, but we plan to add a more UI-friendly editor.  
+   
+   <Image img={require('../../img/secret_manager_settings.png')} />
+
+4. **Create the team**  
+   Review the inputs and click `Create Team` to save.  
+   
+   <Image img={require('../../img/secret_manager_settings_create_button.png')} />
+
+Once saved, LiteLLM will use this configuration.