diff --git a/documentation-website/Writerside/topics/Breaking-Changes.md b/documentation-website/Writerside/topics/Breaking-Changes.md
index 9b0ee179f9..437946f1aa 100644
--- a/documentation-website/Writerside/topics/Breaking-Changes.md
+++ b/documentation-website/Writerside/topics/Breaking-Changes.md
@@ -34,6 +34,15 @@
 
 The 1.0.0-beta-1 release introduces support for R2DBC and includes breaking changes to import paths.
 
+On the way to Exposed 1.0, several changes were made to package names. There are two key changes in package naming: unique prefixes for every module and artifact, and
+adding a `v1` prefix to all packages.
+
+With the unique prefix on every module, it would be easier to differentiate which dependency a particular class, function, or other element comes from. This becomes
+more important as the number of packages grows larger.
+
+The unique `v1` prefix for the whole version will help users who have transient dependencies to the `0.x` version of Exposed. It's expected that every major release
+could change that prefix.
+
 ### Updated JDBC imports
 
 Imports of the `exposed-jdbc` package previously under `org.jetbrains.exposed.sql.*` are now
diff --git a/documentation-website/Writerside/topics/Migration-Guide-1-0-0.md b/documentation-website/Writerside/topics/Migration-Guide-1-0-0.md
index ca5c972bca..707d61c814 100644
--- a/documentation-website/Writerside/topics/Migration-Guide-1-0-0.md
+++ b/documentation-website/Writerside/topics/Migration-Guide-1-0-0.md
@@ -25,6 +25,8 @@ are now located under `org.jetbrains.exposed.v1.core.*`. The table below shows e
 | `org.jetbrains.exposed.sql.javatime.datetime` | `org.jetbrains.exposed.v1.javatime.datetime`    |
 | `org.jetbrains.exposed.sql.json.json`         | `org.jetbrains.exposed.v1.json.json`            |
 
+Check [Breaking Changes - 1.0.0-beta-1](https://www.jetbrains.com/help/exposed/breaking-changes.html#1-0-0-beta-1) for more details about the changes in imports.  
+
 ### Moved imports
 
 The major design change for allowing R2DBC functionality involved extracting some of the classes and interfaces