diff --git a/src/__changelog/mod.rs b/src/__changelog/mod.rs
index b0db5235fb..24826661f7 100644
--- a/src/__changelog/mod.rs
+++ b/src/__changelog/mod.rs
@@ -1,6 +1,7 @@
-//! # Changelog
+//! # Changelog and migrations
 //!
-//! All notable changes to this project will be documented in this module.
+//! All notable changes to this project will be documented in this module,
+//! along with migration instructions for larger changes.
 
 // Put the current changelog entry at the top of rustdoc output.
 pub use unreleased as current;