diff --git a/README.md b/README.md
index 631e32d984..418d1613f9 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,10 @@
 # Starting point
 
+> **Warning**
+> Startingpoint was recently rewritten, and this version is considered a "1.0" *semi-*stable release.
+> There are breaking changes between this and the previous version.
+> If you are merging changes from the previous (v0) version, please refer to [the heads-up blog post](https://universal-blue.org/blog/2023/09/02/startingpoint-rewrite-heads-up-what-you-need-to-know/).
+
 [![build-ublue](https://github.com/ublue-os/startingpoint/actions/workflows/build.yml/badge.svg)](https://github.com/ublue-os/startingpoint/actions/workflows/build.yml)
 
 This is a constantly updating template repository for creating [a native container image](https://fedoraproject.org/wiki/Changes/OstreeNativeContainerStable) designed to be customized however you want. GitHub will build your image for you, and then host it for you on [ghcr.io](https://github.com/features/packages). You then just tell your computer to boot off of that image. GitHub keeps 90 days worth image backups for you, thanks Microsoft!