diff --git a/share/doc/sshyp/changelog b/share/doc/sshyp/changelog
index 41c4b1d..62f75a3 100644
--- a/share/doc/sshyp/changelog
+++ b/share/doc/sshyp/changelog
@@ -1,7 +1,12 @@
-sshyp v1.4.2 - 04/25/2023 (draft)
+sshyp v1.4.2
+04/25/2023 (draft)
 
 the argumentative agronomist update - patch two
 
+IMPORTANT: the next major release of sshyp, v1.5.0, will make breaking changes that will require
+running through 'sshyp tweak' again - also starting with v1.5.0, a copy of the changelog will no
+longer be packaged with sshyp (it will still be available on GitHub)
+
 this release makes use of a new ports framework to make sshyp even smaller and faster than before
 
 user-facing features: