diff --git a/README.md b/README.md
index c5a84b15..37ae93a9 100644
--- a/README.md
+++ b/README.md
@@ -6,8 +6,8 @@ A friendly data-driven router for Clojure(Script).
 * Route [conflict resolution](https://metosin.github.io/reitit/basics/route_conflicts.html)
 * First-class [route data](https://metosin.github.io/reitit/basics/route_data.html)
 * Bi-directional routing
-* [Ring-router](https://metosin.github.io/reitit/ring/ring.html) with [data-driven middleware](https://metosin.github.io/reitit/ring/data_driven_middleware.html)
 * [Pluggable coercion](https://metosin.github.io/reitit/coercion/coercion.html) ([schema](https://github.com/plumatic/schema) & [clojure.spec](https://clojure.org/about/spec))
+* [Ring-router](https://metosin.github.io/reitit/ring/ring.html) with [data-driven middleware](https://metosin.github.io/reitit/ring/data_driven_middleware.html)
 * Extendable
 * Modular
 * [Fast](https://metosin.github.io/reitit/performance.html)
diff --git a/doc/SUMMARY.md b/doc/SUMMARY.md
index bf23d439..4ca4b31c 100644
--- a/doc/SUMMARY.md
+++ b/doc/SUMMARY.md
@@ -17,6 +17,7 @@
     * [Configuring Routers](advanced/configuring_routers.md)
     * [Different Routers](advanced/different_routers.md)
     * [Route Validation](advanced/route_validation.md)
+    * [Interceptors](advanced/interceptors.md)
 * [Ring](ring/README.md)
     * [Ring-router](ring/ring.md)
     * [Dynamic Extensions](ring/dynamic_extensions.md)
@@ -26,4 +27,3 @@
 * [Performance](performance.md)
 * [FAQ](faq.md)
 * TODO: Swagger & OpenAPI
-* TODO: Interceptors
diff --git a/doc/advanced/README.md b/doc/advanced/README.md
index cad41444..3bb47889 100644
--- a/doc/advanced/README.md
+++ b/doc/advanced/README.md
@@ -3,3 +3,4 @@
 * [Configuring Routers](configuring_routers.md)
 * [Different Routers](different_routers.md)
 * [Route Validation](route_validation.md)
+* [Interceptors](interceptors.md)
diff --git a/doc/advanced/interceptors.md b/doc/advanced/interceptors.md
new file mode 100644
index 00000000..441fed49
--- /dev/null
+++ b/doc/advanced/interceptors.md
@@ -0,0 +1,11 @@
+# Interceptors
+
+Reitit also supports [Pedestal](pedestal.io)-style [interceptors](http://pedestal.io/reference/interceptors).
+
+## work in progress
+
+* port the (coericon) middleware into interceptors
+* separate Clojure(Script) runner?
+* Docs
+* Samples
+