diff --git a/doc/ring/default_middleware.md b/doc/ring/default_middleware.md
index 9b1d64cc..30afc625 100644
--- a/doc/ring/default_middleware.md
+++ b/doc/ring/default_middleware.md
@@ -6,10 +6,18 @@
 
 Any Ring middleware can be used with `reitit-ring`, but using data-driven middleware is preferred as they are easier to manage and in many cases, yield better performance. `reitit-middleware` contains a set of common ring middleware, lifted into data-driven middleware.
 
+* [Parameter handling](#parameters-handling)
 * [Exception handling](#exception-handling)
 * [Content negotiation](#content-negotiation)
 * [Multipart request handling](#multipart-request-handling)
 
+## Parameters handling
+
+`reitit.ring.middleware.parameters/parameters-middleware` to capture query- and form-params. Wraps
+`ring.middleware.params/wrap-params`.
+
+**NOTE**: will be factored into two parts: a query-parameters middleware and a Muuntaja format responsible for the the `application/x-www-form-urlencoded` body format.
+
 ## Exception handling
 
 A polished version of [compojure-api](https://github.com/metosin/compojure-api) exception handling. Catches all exceptions and invokes configured exception handler.