diff --git a/config/database.yml.development-sample b/config/database.yml.development-sample
index 3db73c252e..74106f2638 100644
--- a/config/database.yml.development-sample
+++ b/config/database.yml.development-sample
@@ -6,7 +6,9 @@ development:
   pool: 5
   timeout: 5000
   host_names:
-    # /!\ Make sure you *also* restart sidekiq if you change this setting /!\
+    ### If you change this setting you will need to
+    ###   - restart sidekiq if you change this setting
+    ###   - rebake all to posts using: `RAILS_ENV=production bundle exec rake posts:rebake`
     - "localhost"
 
 # Warning: The database defined as "test" will be erased and
@@ -30,7 +32,9 @@ production:
   pool: 5
   timeout: 5000
   host_names:
-    # /!\ Make sure you *also* restart sidekiq if you change this setting /!\
+    ### If you change this setting you will need to
+    ###   - restart sidekiq if you change this setting
+    ###   - rebake all to posts using: `RAILS_ENV=production bundle exec rake posts:rebake`
     - production.localhost # Update this to be the domain of your production site
 
 profile:
diff --git a/config/database.yml.production-sample b/config/database.yml.production-sample
index 4943d0d07b..f12389e929 100644
--- a/config/database.yml.production-sample
+++ b/config/database.yml.production-sample
@@ -8,7 +8,9 @@ production:
   timeout: 5000
   # db_id: 0	# database ID if hosting multiple sites
   host_names:
-    # /!\ Make sure you *also* restart sidekiq if you change this setting /!\
+    ### If you change this setting you will need to
+    ###   - restart sidekiq if you change this setting
+    ###   - rebake all to posts using: `RAILS_ENV=production bundle exec rake posts:rebake`
     - production.localhost # Update this to be the domain of your production site
 
 test:
diff --git a/config/multisite.yml.production-sample b/config/multisite.yml.production-sample
index ed17af240f..9c7accece6 100644
--- a/config/multisite.yml.production-sample
+++ b/config/multisite.yml.production-sample
@@ -1,26 +1,30 @@
-mlp: 
-   adapter: postgresql
-   database: discourse_mlp
-   username: discourse_mlp
-   password: applejack
-   host: dbhost
-   pool: 5
-   timeout: 5000
-   db_id: 1	# ensure db_id is unique for each site
-   host_names:
-     - discourse.equestria.com
-     - discourse.equestria.internal
+mlp:
+  adapter: postgresql
+  database: discourse_mlp
+  username: discourse_mlp
+  password: applejack
+  host: dbhost
+  pool: 5
+  timeout: 5000
+  db_id: 1	# ensure db_id is unique for each site
+  ### If you change this setting you will need to
+  ###   - restart sidekiq if you change this setting
+  ###   - rebake all to posts using: `RAILS_ENV=production bundle exec rake posts:rebake`
+  host_names:
+    - discourse.equestria.com
+    - discourse.equestria.internal
 
 drwho:
-   adapter: postgresql
-   database: discourse_who
-   username: discourse_who
-   password: "Up the time stream without a TARDIS"
-   host: dbhost
-   pool: 5
-   timeout: 5000
-   db_id: 	# ensure db_id is unique for each site
-   host_names:
-     - discuss.tardis.gallifrey
-
-
+  adapter: postgresql
+  database: discourse_who
+  username: discourse_who
+  password: "Up the time stream without a TARDIS"
+  host: dbhost
+  pool: 5
+  timeout: 5000
+  db_id: 	# ensure db_id is unique for each site
+  ### If you change this setting you will need to
+  ###   - restart sidekiq if you change this setting
+  ###   - rebake all to posts using: `RAILS_ENV=production bundle exec rake posts:rebake`
+  host_names:
+    - discuss.tardis.gallifrey