[docs] Minor tidying for ddev pull platform PRs #4441 and #4426 (#4469

) [skip ci]
ddev · Dec 20, 2022 · 68309ef · 68309ef
1 parent 2d289ca
commit 68309ef
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 6 deletions.
diff --git a/docs/content/users/basics/commands.md b/docs/content/users/basics/commands.md
@@ -553,7 +553,7 @@ Flags:
 
 * `--all`: List unofficial *and* official add-ons. (default `true`)
 * `--list`: List official add-ons. (default `true`)
-* `--verbose` or `-v`: Output verbose error information with bash `set -x` (default `false`)
+* `--verbose`, `-v`: Output verbose error information with Bash `set -x` (default `false`)
 
 Example:
 
@@ -570,7 +570,6 @@ ddev get drud/ddev-redis
 # Get debug info about `ddev get` failure
 ddev get drud/ddev-redis --verbose
 
-
 # Download the Drupal 9 Solr add-on from its v0.0.5 release tarball
 ddev get https://github.com/drud/ddev-drupal9-solr/archive/refs/tags/v0.0.5.tar.gz
 

diff --git a/docs/content/users/providers/platform.md b/docs/content/users/providers/platform.md
@@ -42,15 +42,19 @@ web_environment:
 4. Run `ddev pull platform`. After you agree to the prompt, the current upstream databases and files will be downloaded.
 5. Optionally use `ddev push platform` to push local files and database to Platform.sh. The [`ddev push`](../basics/commands.md#push) command can potentially damage your production site, so we don’t recommend using it.
 
-If you have more than one database on your Platform.sh project, you'll need to choose which one you want to use
-as the 'db' primary database on DDEV, and that one will be pulled to the database named `db`.
-Do this by setting PLATFORM_PRIMARY_RELATIONSHIP, for example,
+### Managing Multiple Databases
+
+If your project has only one database, it will automatically be pulled into and pushed from DDEV’s `'db'` database.
+
+If your project has multiple databases, they’ll all be pulled into DDEV with their respective remote names. You can optionally designate a *primary* to use DDEV’s default `'db'` database, which may be useful in some cases—particularly if you’ve been using the default solo-database behavior and happened to add another one to your project.
+
+You can designate the primary database using the `PLATFORM_PRIMARY_RELATIONSHIP` environment variable:
 
 ```
 ddev config --web-environment-add="PLATFORM_PRIMARY_RELATIONSHIP=main"
 ```
 
-or run `ddev pull platform` with the `--environment` flag, for example,
+You can also do the same thing by running `ddev pull platform` and using the `--environment` flag:
 
 ```
 ddev pull platform --environment="PLATFORM_PRIMARY_RELATIONSHIP=main"