diff --git a/doc/basics/name_based_routing.md b/doc/basics/name_based_routing.md index 5f66d0f6..97016b3d 100644 --- a/doc/basics/name_based_routing.md +++ b/doc/basics/name_based_routing.md @@ -1,6 +1,6 @@ # Name-based (reverse) Routing -All routes which have `:name` route data defined, can also be matched by name. +All routes which have `:name` route data defined can also be matched by name. Given a router: diff --git a/doc/basics/route_conflicts.md b/doc/basics/route_conflicts.md index b401a61f..4f6a02c9 100644 --- a/doc/basics/route_conflicts.md +++ b/doc/basics/route_conflicts.md @@ -1,6 +1,6 @@ # Route Conflicts -We should fast if a router contains conflicting paths or route names. +We should fail fast if a router contains conflicting paths or route names. When a `Router` is created via `reitit.core/router`, both path and route name conflicts are checked automatically. By default, in case of conflict, an `ex-info` is thrown with a descriptive message. In some (legacy api) cases, path conflicts should be allowed and one can override the path conflict resolution via `:conflicts` router option. diff --git a/doc/basics/route_data_validation.md b/doc/basics/route_data_validation.md index bc98ea1a..b3b9cde9 100644 --- a/doc/basics/route_data_validation.md +++ b/doc/basics/route_data_validation.md @@ -1,6 +1,6 @@ # Route Data Validation -Route data can be anything, so it's easy to do go wrong. Accidentally adding a `:role` key instead of `:roles` might hinder the whole routing app without any authorization in place. +Route data can be anything, so it's easy to go wrong. Accidentally adding a `:role` key instead of `:roles` might hinder the whole routing app without any authorization in place. To fail fast, we could use the custom `:coerce` and `:compile` hooks to apply data validation and throw exceptions on first sighted problem.