diff --git a/src/gles_render/mod.rs b/src/gles_render/mod.rs
index 8b19af6..ac08b59 100644
--- a/src/gles_render/mod.rs
+++ b/src/gles_render/mod.rs
@@ -138,7 +138,7 @@ pub struct GlesCanvas
 	/// theme registry.
 	pub font:         Arc<Font>,
 	/// Raw bytes of the default font. Required by rustybuzz for
-	/// HarfBuzz shaping (see [`crate::text_shaping`]). Kept on the
+	/// HarfBuzz shaping (see the `text_shaping` private module). Kept on the
 	/// canvas so the shape pipeline has direct access without a
 	/// global lookup.
 	pub font_bytes:   Arc<Vec<u8>>,
diff --git a/src/theme/active.rs b/src/theme/active.rs
index e27b08e..e58f421 100644
--- a/src/theme/active.rs
+++ b/src/theme/active.rs
@@ -126,7 +126,7 @@ pub fn active_mode() -> ThemeMode
 }
 
 /// The currently loaded theme document. Use this for slot-typed lookups
-/// when the per-slot helpers ([`crate::theme::color`], [`crate::theme::surface`], …) are not
+/// when the per-slot helpers ([`crate::theme::color`], [`crate::theme::surface()`], …) are not
 /// expressive enough — e.g. iterating `mode.slots.entries`.
 pub fn active_document() -> Arc<ThemeDocument>
 {
diff --git a/src/theme/mod.rs b/src/theme/mod.rs
index 45f4fda..6b20c6f 100644
--- a/src/theme/mod.rs
+++ b/src/theme/mod.rs
@@ -32,7 +32,7 @@
 //! state. Use [`set_active_document`] / [`set_active_mode`] to change it,
 //! and [`active_document`] / [`active_mode`] / [`active_theme_id`] to read
 //! it back. Per-slot shorthand accessors ([`color`], [`paint()`], [`surface()`],
-//! [`palette`], …) cover the common patterns without going through the
+//! [`palette()`], …) cover the common patterns without going through the
 //! full document.
 //!
 //! There is **no in-code fallback**: if `ensure_active` cannot locate the
diff --git a/src/theme/palette.rs b/src/theme/palette.rs
index 36f3c67..bc3808d 100644
--- a/src/theme/palette.rs
+++ b/src/theme/palette.rs
@@ -51,7 +51,7 @@ impl Palette
 	/// (`bg-page`, `surface`, `surface-alt`, `text-primary`,
 	/// `text-secondary`, `accent`, `divider`, `icon`). Missing slots
 	/// fall back to a documented sensible default so downstream widgets
-	/// never see uninitialised colours. Used by [`crate::theme::palette`] and
+	/// never see uninitialised colours. Used by [`crate::theme::palette()`] and
 	/// [`crate::theme::window_controls`].
 	pub fn from_slots( slots: &SlotStore ) -> Self
 	{
diff --git a/src/widget/scroll/mod.rs b/src/widget/scroll/mod.rs
index 16fcd13..98a84dc 100644
--- a/src/widget/scroll/mod.rs
+++ b/src/widget/scroll/mod.rs
@@ -8,7 +8,7 @@ use crate::widget::Element;
 #[cfg(test)]
 mod tests;
 
-/// Which axes a [`Scroll`] viewport allows to move along. Determines
+/// Which axes a `Scroll` viewport allows to move along. Determines
 /// whether the layout grows the child past the viewport width, the
 /// viewport height, or both, and which axis gesture / wheel deltas
 /// route to.
@@ -139,7 +139,7 @@ pub(crate) fn clamp_offset( offset: f32, content_h: f32, viewport_h: f32 ) -> f3
 }
 
 /// Create a scrollable viewport wrapping `child`. Defaults to vertical
-/// scrolling; chain [`Scroll::horizontal`] or [`Scroll::both`] to
+/// scrolling; chain `Scroll::horizontal` or `Scroll::both` to
 /// switch axes.
 ///
 /// The parent layout controls the viewport size by assigning a rect to
diff --git a/src/widget/text_edit/mod.rs b/src/widget/text_edit/mod.rs
index de7f894..cafe1a8 100644
--- a/src/widget/text_edit/mod.rs
+++ b/src/widget/text_edit/mod.rs
@@ -4,7 +4,7 @@
 //! Text input field — single-line or multiline. The widget itself
 //! owns layout / draw; the runtime side of text editing
 //! (insert, delete, cursor movement, selection, clipboard)
-//! lives in [`crate::event_loop::text_editing`].
+//! lives in the `event_loop::text_editing` private module.
 
 use std::sync::Arc;