diff --git a/docs/en/changelogs/3.1.0.md b/docs/en/changelogs/3.1.0.md
index 9dc4482ad..c41938a44 100644
--- a/docs/en/changelogs/3.1.0.md
+++ b/docs/en/changelogs/3.1.0.md
@@ -126,6 +126,11 @@ your `.htaccess` or `web.config` files. Web access to these sensitive YAML confi
 needs to be explicitly denied through these configuration files (see the [3.0.5 security release](/changelogs/3.0.4))
 for details.
 
+This change will also affect any visibility modifiers on `SiteTree` subclasses
+in your own codebase, since those are further extended by SilverStripe core,
+e.g. `ErrorPage extends Page`.  Please change all "core statics" like `$db`, `$has_one`,
+`$has_many`, `$many_many`, `$defaults`, etc to `private` visibility.
+
 For more information about how to use the config system, see the ["Configuration" topic](/topic/configuration).
 
 ### default_cast is now Text