Document the router options

modules/reitit-core/src/reitit/interceptor.cljc

@@ -129,23 +129,22 @@
 
 (defn router
   "Creates a [[reitit.core/Router]] from raw route data and optionally an options map with
-  support for Interceptors. See [docs](https://metosin.github.io/reitit/) for details.
+  support for Interceptors. See documentation on [[reitit.core/router]] for available options.
+  In addition, the following options are available:
+
+  Options:
+
+  | key                             | description
+  | --------------------------------|-------------
+  | `:reitit.interceptor/transform` | Function or vector of functions of type `[Interceptor] => [Interceptor]` to transform the expanded Interceptors (default: identity).
+  | `:reitit.interceptor/registry`  | Map of `keyword => IntoInterceptor` to replace keyword references into Interceptor
 
   Example:
 
       (router
         [\"/api\" {:interceptors [format-body oauth2]}
         [\"/users\" {:interceptors [delete]
-                     :handler get-user}]])
+                     :handler get-user}]])"
-
-  Options:
-
-  | key                             | description
-  | --------------------------------|-------------
-  | `:reitit.interceptor/transform` | Function of [Interceptor] => [Interceptor] to transform the expanded Interceptors (default: identity).
-  | `:reitit.interceptor/registry`  | Map of `keyword => IntoInterceptor` to replace keyword references into Interceptor
-
-  See router options from [[reitit.core/router]]."
   ([data]
    (router data nil))
   ([data opts]

modules/reitit-core/src/reitit/middleware.cljc

@@ -122,23 +122,20 @@
 
 (defn router
   "Creates a [[reitit.core/Router]] from raw route data and optionally an options map with
-  support for Middleware. See [docs](https://metosin.github.io/reitit/) for details.
+  support for Middleware. See documentation on [[reitit.core/router]] for available options.
+  In addition, the following options are available:
+
+  | key                            | description
+  | -------------------------------|-------------
+  | `:reitit.middleware/transform` | Function or vector of functions of type `[Middleware] => [Middleware]` to transform the expanded Middleware (default: identity)
+  | `:reitit.middleware/registry`  | Map of `keyword => IntoMiddleware` to replace keyword references into Middleware
 
   Example:
 
       (router
         [\"/api\" {:middleware [wrap-format wrap-oauth2]}
         [\"/users\" {:middleware [wrap-delete]
-                     :handler get-user}]])
+                     :handler get-user}]])"
-
-  Options:
-
-  | key                            | description |
-  | -------------------------------|-------------|
-  | `:reitit.middleware/transform` | Function of `[Middleware] => [Middleware]` to transform the expanded Middleware (default: identity).
-  | `:reitit.middleware/registry`  | Map of `keyword => IntoMiddleware` to replace keyword references into Middleware
-
-  See other router options from [[reitit.core/router]]."
   ([data]
    (router data nil))
   ([data opts]

modules/reitit-frontend/src/reitit/frontend.cljs

@@ -40,7 +40,7 @@
 
 (defn router
   "Create a `reitit.core.router` from raw route data and optionally an options map.
-  Enables request coercion. See [[reitit.core.router]] for details on options."
+  Enables request coercion. See [[reitit.core/router]] for details on options."
   ([raw-routes]
    (router raw-routes {}))
   ([raw-routes opts]

modules/reitit-http/src/reitit/http.cljc

@@ -47,14 +47,12 @@
 
 (defn router
   "Creates a [[reitit.core/Router]] from raw route data and optionally an options map with
-  support for http-methods and Interceptors. See [docs](https://metosin.github.io/reitit/)
+  support for http-methods and Interceptors. See documentation on [[reitit.core/router]]
-  for details.
+  for available options. In addition, the following options are available:
 
-  Options:
+  | key                                    | description
-
+  | ---------------------------------------|-------------
-  | key                                    | description |
+  | `:reitit.interceptor/transform`        | Function or vector of functions of type `[Interceptor] => [Interceptor]` to transform the expanded Interceptors (default: identity)
-  | ---------------------------------------|-------------|
-  | `:reitit.interceptor/transform`         | Function of `[Interceptor] => [Interceptor]` to transform the expanded Interceptors (default: identity).
   | `:reitit.interceptor/registry`         | Map of `keyword => IntoInterceptor` to replace keyword references into Interceptors
   | `:reitit.http/default-options-handler` | Default handler for `:options` method in endpoints (default: reitit.ring/default-options-handler)
 
@@ -65,9 +63,7 @@
           [\"/users\" {:get get-user
                        :post update-user
                        :delete {:interceptors [delete-i]
-                               :handler delete-user}}]])
+                               :handler delete-user}}]])"
-
-  See router options from [[reitit.core/router]] and [[reitit.middleware/router]]."
   ([data]
    (router data nil))
   ([data opts]

modules/reitit-ring/src/reitit/ring.cljc

@@ -67,14 +67,12 @@
 
 (defn router
   "Creates a [[reitit.core/Router]] from raw route data and optionally an options map with
-  support for http-methods and Middleware. See [docs](https://metosin.github.io/reitit/)
+  support for http-methods and Middleware. See documentation on [[reitit.core/router]] for
-  for details.
+  available options. In addition, the following options are available:
 
-  Options:
+  | key                                    | description
-
+  | ---------------------------------------|-------------
-  | key                                    | description |
+  | `:reitit.middleware/transform`         | Function or vector of functions of type `[Middleware] => [Middleware]` to transform the expanded Middleware (default: identity)
-  | ---------------------------------------|-------------|
-  | `:reitit.middleware/transform`         | Function of `[Middleware] => [Middleware]` to transform the expanded Middleware (default: identity).
   | `:reitit.middleware/registry`          | Map of `keyword => IntoMiddleware` to replace keyword references into Middleware
   | `:reitit.ring/default-options-handler` | Default handler for `:options` method in endpoints (default: default-options-handler)