thomasgauvin:rename file and add note to update in situ

Author: thomasgauvin

src/content/docs/hyperdrive/configuration/connect-to-private-database copy.mdx renamed to src/content/docs/hyperdrive/configuration/rotate-credentials.mdx

@@ -12,9 +12,11 @@ You can change the connection information and the connection credentials of your
 1. (Recommended) Create a new Hyperdrive configuration with the new connection information and credentials, and update your Worker to use the new Hyperdrive configuration.
 2. Update the existing Hyperdrive configuration with the new connection information and credentials.
 
-## Use a new Hyperdrive configuration
+## Use a new Hyperdrive configuration (Recommended)
 
-Creating a new Hyperdrive configuration to update your database credentials allows you to keep your existing Worker configuration unchanged, gradually migrate your Worker to the new Hyperdrive configuration and easily roll back to the previous configuration if needed. To create a Hyperdrive that connects to an existing PostgreSQL database, use the [wrangler](/workers/wrangler/install-and-update/) CLI or the [Cloudflare dashboard](https://dash.cloudflare.com/?to=/:account/workers-and-pages/hyperdrive).
+Creating a new Hyperdrive configuration to update your database credentials allows you to keep your existing Worker configuration unchanged, gradually migrate your Worker to the new Hyperdrive configuration and easily roll back to the previous configuration if needed.
+
+To create a Hyperdrive that connects to an existing PostgreSQL database, use the [wrangler](/workers/wrangler/install-and-update/) CLI or the [Cloudflare dashboard](https://dash.cloudflare.com/?to=/:account/workers-and-pages/hyperdrive).
 
 ```sh
 # wrangler v3.11 and above required
@@ -32,7 +34,7 @@ binding = "HYPERDRIVE"
 id = "<your-hyperdrive-id-here>"
 ```
 
-To update your Worker to use the new Hyperdrive configuration, redeploy your Worker or use [gradual deployments](https://developers.cloudflare.com/workers/configuration/versions-and-deployments/gradual-deployments/).
+To update your Worker to use the new Hyperdrive configuration, redeploy your Worker or use [gradual deployments](/workers/configuration/versions-and-deployments/gradual-deployments/).
 
 ## Update the existing Hyperdrive configuration
 
@@ -42,3 +44,7 @@ You can update the configuration of an existing Hyperdrive configuration using t
 # wrangler v3.11 and above required
 npx wrangler hyperdrive update <HYPERDRIVE_CONFIG_ID> --origin-host <YOUR_ORIGIN_HOST> --origin-password <YOUR_ORIGIN_PASSWORD> --origin-user <YOUR_ORIGIN_USERNAME> --database <YOUR_DATABASE> --origin-port <YOUR_ORIGIN_PORT>
 ```
+
+:::note
+Updating the settings of an existing Hyperdrive configuration does not purge Hyperdrive's cache and does not tear down the existing database connection pool. New connections will be established using the new connection information.
+:::