diff --git a/doc/README.md b/doc/README.md
index 00593698..b52bc1f6 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -10,7 +10,6 @@
 * Extendable
 * Modular
 * [Fast](performance.md)
-* [Frontend routing](./frontend/README.md)
 
 Modules:
 
@@ -20,7 +19,7 @@ Modules:
 * `reitit-schema` [Schema](https://github.com/plumatic/schema) coercion
 * `reitit-swagger` [Swagger2](https://swagger.io/) apidocs
 * `reitit-swagger-ui` Integrated [Swagger UI](https://github.com/swagger-api/swagger-ui).
-* `reitit-frontend` Tools for frontend routing.
+* [`reitit-frontend`](frontend/basics.md) Tools for frontend routing.
 
 To use Reitit, add the following dependency to your project:
 
diff --git a/doc/SUMMARY.md b/doc/SUMMARY.md
index 9fa17fa7..cf0ceb44 100644
--- a/doc/SUMMARY.md
+++ b/doc/SUMMARY.md
@@ -27,7 +27,7 @@
     * [Static Resources](ring/static.md)
     * [Dynamic Extensions](ring/dynamic_extensions.md)
     * [Data-driven Middleware](ring/data_driven_middleware.md)
-    * [Transforming Middleware Chain](transforming_middleware_chain.md)
+    * [Transforming Middleware Chain](ring/transforming_middleware_chain.md)
     * [Middleware Registry](ring/middleware_registry.md)
     * [Default Middleware](ring/default_middleware.md)
     * [Pluggable Coercion](ring/coercion.md)
diff --git a/doc/ring/transforming_middleware_chain.md b/doc/ring/transforming_middleware_chain.md
index 6179bffb..55d60d08 100644
--- a/doc/ring/transforming_middleware_chain.md
+++ b/doc/ring/transforming_middleware_chain.md
@@ -1,4 +1,4 @@
-# Transformation Middleware Chain
+# Transforming the Middleware Chain
 
 There is an extra option in ring-router (actually, in the underlying middleware-router): `:reitit.middleware/transform` to transform the middleware chain per endpoint. It gets the vector of compiled middleware and should return a new vector of middleware.