diff --git a/doc/ring/openapi.md b/doc/ring/openapi.md
index ee6ffd72..34536048 100644
--- a/doc/ring/openapi.md
+++ b/doc/ring/openapi.md
@@ -1,5 +1,7 @@
 # OpenAPI Support
 
+**Stability: alpha**
+
 Reitit can generate [OpenAPI 3.1.0](https://spec.openapis.org/oas/v3.1.0)
 documentation. The feature works similarly to [Swagger documentation](swagger.md).
 
diff --git a/modules/reitit-openapi/src/reitit/openapi.cljc b/modules/reitit-openapi/src/reitit/openapi.cljc
index fa414b63..e97162d9 100644
--- a/modules/reitit-openapi/src/reitit/openapi.cljc
+++ b/modules/reitit-openapi/src/reitit/openapi.cljc
@@ -18,7 +18,9 @@
 (s/def ::spec (s/keys :opt-un [::openapi ::no-doc ::tags ::summary ::description ::content-types]))
 
 (def openapi-feature
-  "Feature for handling openapi-documentation for routes.
+  "Stability: alpha
+
+  Feature for handling openapi-documentation for routes.
   Works both with Middleware & Interceptors. Does not participate
   in actual request processing, just provides specs for the new
   documentation keys for the route data. Should be accompanied by a
@@ -72,7 +74,9 @@
   (-> path (trie/normalize opts) (str/replace #"\{\*" "{")))
 
 (defn create-openapi-handler
-  "Create a ring handler to emit openapi spec. Collects all routes from router which have
+  "Stability: alpha
+
+  Create a ring handler to emit openapi spec. Collects all routes from router which have
   an intersecting `[:openapi :id]` and which are not marked with `:no-doc` route data."
   []
   (fn create-openapi