diff --git a/src/config-schema.coffee b/src/config-schema.coffee
index 299d8b765..f849e4909 100644
--- a/src/config-schema.coffee
+++ b/src/config-schema.coffee
@@ -170,7 +170,7 @@ module.exports =
         type: 'boolean'
         default: true
         title: 'Use Shadow DOM'
-        description: 'Enable to test out themes and packages with the new shadow DOM before it ships by default.'
+        description: 'Disable if you experience styling issues with packages or themes. Be sure to open an issue on the relevant package or theme, because this option is going away eventually.'
       confirmCheckoutHeadRevision:
         type: 'boolean'
         default: true