diff --git a/README.md b/README.md
index ae24c2cc..8627966e 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@ A friendly data-driven router for Clojure(Script).
 * First-class [route meta-data](https://metosin.github.io/reitit/basics.html#route-data)
 * Generic, not tied to HTTP
 * [Route conflict resolution](https://metosin.github.io/reitit/route_conflicts.html)
-* [Pluggable coercion](https://metosin.github.io/reitit/route_validation.html) ([clojure.spec](https://clojure.org/about/spec))
+* [Pluggable coercion](https://metosin.github.io/reitit/parameter_coercion.html) ([clojure.spec](https://clojure.org/about/spec))
 * both [Middleware](https://metosin.github.io/reitit/compiling_middleware.html) & Interceptors
 * Extendable
 * Fast
diff --git a/doc/README.md b/doc/README.md
index 9b9e1b02..438dbfa5 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -2,11 +2,11 @@
 
 [Reitit](https://github.com/metosin/reitit) is a small Clojure(Script) library for data-driven routing.
 
-* Simple data-driven [route syntax](./routing/route_syntax.md)
-* First-class [route meta-data](./routing/route_metadata.md)
+* Simple data-driven [route syntax](./basics.md#route-syntax)
+* First-class [route meta-data](./basics.md#route-data)
 * Bi-directional-routing
-* [Route conflict resolution](./routing/route_conflicts.md)
-* [Pluggable coercion](./parameter-coercion.md) ([clojure.spec](https://clojure.org/about/spec))
+* [Route conflict resolution](./route_conflicts.md)
+* [Pluggable coercion](./parameter_coercion.md) ([clojure.spec](https://clojure.org/about/spec))
 * Both [Middleware](./ring.md#middleware) & Interceptors
 * Extendable
 * Fast