deny missing docs in router

packages/router/src/hooks/use_navigate.rs

@@ -10,6 +10,8 @@ use crate::{RouterError, utils::use_router_internal::use_router_internal};
 ///   component calling the [`use_router`] hook.
 /// - Otherwise [`Ok`].
 ///
+/// [`use_router`]: crate::hooks::use_router
+///
 /// # Panic
 /// - When the calling component is not nested within another component calling the [`use_router`]
 ///   hook, but only in debug builds.

packages/router/src/hooks/use_route.rs

@@ -2,7 +2,7 @@ use async_rwlock::RwLockReadGuard;
 use dioxus::{core::Component, prelude::ScopeState};
 use dioxus_router_core::RouterState;
 
-use crate::{RouterError, utils::use_router_internal::use_router_internal};
+use crate::{utils::use_router_internal::use_router_internal, RouterError};
 
 /// A hook that provides access to information about the current routing location.
 ///
@@ -55,7 +55,7 @@ use crate::{RouterError, utils::use_router_internal::use_router_internal};
 /// # assert_eq!(dioxus_ssr::render(&vdom), "<h1>App</h1><h2>Current Path</h2><p>/some/path</p>")
 /// ```
 ///
-/// [`use_router`]: super::use_router
+/// [`use_router`]: crate::hooks::use_router
 #[must_use]
 pub fn use_route<'a>(
     cx: &'a ScopeState,

packages/router/src/hooks/use_router.rs

@@ -27,15 +27,16 @@ use crate::{
 ///
 /// # Return values
 /// This hook returns the current router state and a navigator. For more information about the
-/// state, see the [`use_route`](super::use_route) hook. For more information about the
-/// [`Navigator`], see its own documentation and the [`use_navigate`](super::use_navigate) hook.
+/// state, see the [`use_route`](crate::hooks::use_route) hook. For more information about the
+/// [`Navigator`], see its own documentation and the [`use_navigate`](crate::hooks::use_navigate)
+/// hook.
 ///
 /// # Panic
 /// - When used within a component, that is nested inside another component calling [`use_router`],
 ///   but only in debug builds.
 ///
 /// # Example
-/// ```rust,no_run
+/// ```rust
 /// # use dioxus::prelude::*;
 /// # use dioxus_router::prelude::*;
 /// fn App(cx: Scope) -> Element {
@@ -129,7 +130,7 @@ pub fn use_router<'a>(
 /// Global configuration options for the router.
 ///
 /// This implements [`Default`], so you can use it like this:
-/// ```rust
+/// ```rust,no_run
 /// # use dioxus_router::prelude::RouterConfiguration;
 /// let cfg = RouterConfiguration {
 ///     synchronous: false,

packages/router/src/lib.rs

@@ -1,5 +1,8 @@
+#![doc = include_str!("../README.md")]
+// cannot use forbid, because props derive macro generates #[allow(missing_docs)]
+#![deny(missing_docs)]
+
 /// Components interacting with the router.
-#[deny(missing_docs)]
 pub mod components {
     pub(crate) mod default_errors;
 
@@ -17,16 +20,12 @@ mod contexts {
     pub(crate) mod router;
 }
 
-#[forbid(missing_docs)]
 mod error;
 pub use error::RouterError;
 
-pub mod history {
-    pub use dioxus_router_core::history::*;
-}
+pub use dioxus_router_core::history;
 
 /// Hooks for interacting with the router in components.
-#[forbid(missing_docs)]
 pub mod hooks {
     mod use_navigate;
     pub use use_navigate::*;
@@ -39,7 +38,6 @@ pub mod hooks {
 }
 
 /// A collection of useful items most applications might need.
-#[forbid(missing_docs)]
 pub mod prelude {
     pub use dioxus_router_core::prelude::*;