diff --git a/README.md b/README.md
index 7a0a723..68f9919 100644
--- a/README.md
+++ b/README.md
@@ -19,7 +19,13 @@ _Give your code a start._ ⚡👀
 </div>
 
 > [!WARNING]  
-> **Startle** is _alpha_ and should be considered unstable as its interface is fluid 😅, consider pinning to a version.
+> **Startle** is _beta_ and should be considered unstable as its interface is evolving 😅, consider pinning to a version.
+
+**Status:** A useable MVP for parsing into functions, classes, and dicts (via TypedDicts).
+Core interface is expected to be mostly stable. Recursive parsing is evolving. <br>
+**Roadmap:** See [project board](https://github.com/users/oir/projects/3).
+
+---
 
 **Startle** lets you transform a python function (or functions) into a command line entry point, e.g:
 
diff --git a/docs/README.md b/docs/README.md
index b66cea3..36a851a 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -20,11 +20,12 @@ _Give your code a start._ ⚡👀
 
 </div>
 
-> [!ATTENTION]
-**Startle** is _alpha_ and should be considered unstable as its interface is fluid 😅.
+> [!WARNING]
+**Startle** is _beta_ and should be considered unstable as its interface is evolving 😅.
 Consider pinning to a version.
 
-**Status:** A useable MVP for parsing into functions and classes. Unstable interface. <br>
+**Status:** A useable MVP for parsing into functions, classes, and dicts (via TypedDicts).
+Core interface is expected to be mostly stable. Recursive parsing is evolving. <br>
 **Roadmap:** See [project board](https://github.com/users/oir/projects/3).
 
 ---
diff --git a/pyproject.toml b/pyproject.toml
index 6608d03..dee49aa 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -15,7 +15,7 @@ authors = [
 dynamic = ["version"]
 
 classifiers = [
-  "Development Status :: 3 - Alpha",
+  "Development Status :: 4 - Beta",
 
   "Intended Audience :: Developers",
   "Topic :: Software Development",