diff --git a/doc/settings/database.md b/doc/settings/database.md
index 1324185799582d8ae50eb7339be90f9cc99729e9_ZG9jL3NldHRpbmdzL2RhdGFiYXNlLm1k..07ee8224159a81fcd3e6219143abc903c3cc86f3_ZG9jL3NldHRpbmdzL2RhdGFiYXNlLm1k 100644
--- a/doc/settings/database.md
+++ b/doc/settings/database.md
@@ -948,7 +948,7 @@
 If you have multiple GitLab servers sharing a database, you will want to limit the
 number of nodes that are performing the migration steps during reconfiguration.
 
-Edit `/etc/gitlab/gitlab.rb`:
+Edit `/etc/gitlab/gitlab.rb` to append:
 
 ```ruby
 # Enable or disable automatic database migrations
@@ -952,6 +952,7 @@
 
 ```ruby
 # Enable or disable automatic database migrations
+# on all hosts except the designated deploy node
 gitlab_rails['auto_migrate'] = false
 ```
 
@@ -955,9 +956,6 @@
 gitlab_rails['auto_migrate'] = false
 ```
 
-Don't forget to remove the `#` comment characters at the beginning of this
-line.
-
 `/etc/gitlab/gitlab.rb` should have file permissions `0600` because it contains
 plain-text passwords.
 
@@ -961,7 +959,9 @@
 `/etc/gitlab/gitlab.rb` should have file permissions `0600` because it contains
 plain-text passwords.
 
-The next time a reconfigure is triggered, the migration steps will not be performed.
+The next time hosts carrying the above configuration are reconfigured, the migration steps are not performed.
+
+To avoid schema related post-upgrade errors, the host marked as [the deploy node](https://docs.gitlab.com/ee/update/zero_downtime.html#multi-node--ha-deployment) must have `gitlab_rails['auto_migrate'] = true` during upgrades.
 
 ### Setting client statement_timeout