diff --git a/CHANGELOG.adoc b/CHANGELOG.adoc
index c4ce058f..19cd07e0 100644
--- a/CHANGELOG.adoc
+++ b/CHANGELOG.adoc
@@ -16,11 +16,15 @@ For a list of breaking changes see link:#v1-breaking[breaking changes].
 
 === Unreleased
 
+=== v1.0.699-alpha
+
 * team update: @borkdude is now officially a co-maintainer of rewrite-clj! Woot woot!
 * rewrite-clj v1 minimimum Clojure version is now v1.8.0 (was formerly v1.9.0) https://github.com/clj-commons/rewrite-clj/issues/164[#164]
 * internal rewrite-clj developer facing:
 ** Migrate from `depstar` to `tools.build`
 
+https://github.com/clj-commons/rewrite-clj/compare/v1.0.682-alpha\...v1.0.699-alpha[Gritty details of changes for this release]
+
 === v1.0.682-alpha
 
 * update clojure tools.reader dependency to v1.3.6
diff --git a/doc/01-user-guide.adoc b/doc/01-user-guide.adoc
index 5b9dd39d..633530c5 100644
--- a/doc/01-user-guide.adoc
+++ b/doc/01-user-guide.adoc
@@ -130,7 +130,7 @@ Include the following dependency in your `deps.edn` file:
 // NOTE: the version in this snippit is automatically updated by our release workflow
 [source,clojure]
 ----
-rewrite-clj/rewrite-clj {:mvn/version "1.0.682-alpha"}
+rewrite-clj/rewrite-clj {:mvn/version "1.0.699-alpha"}
 ----
 
 === Leiningen
@@ -139,7 +139,7 @@ Include the following dependency in your `project.clj` file:
 // NOTE: the version in this snippit is automatically update by our release workflow
 [source,clojure]
 ----
-[rewrite-clj/rewrite-clj "1.0.682-alpha"]
+[rewrite-clj/rewrite-clj "1.0.699-alpha"]
 ----
 
 == Rewrite-clj APIs