diff --git a/src/widgets/image.rs b/src/widgets/image.rs
index 2243860..98d54ce 100644
--- a/src/widgets/image.rs
+++ b/src/widgets/image.rs
@@ -16,6 +16,17 @@
 //
 // SPDX-License-Identifier: GPL-3.0-or-later
 
+//! A widget that shows images and handles control inputs
+//!
+//! This widget handles showing the right section of the image
+//! with a spicfic zoom level and rotation. It also handles control
+//! input that change those properties.
+//!
+//! While this widget logically coposes the image, decoding images
+//! and composing the textures happens in [`decoder`].
+//!
+//! [`decoder`]: crate::decoder
+
 use crate::deps::*;
 
 use crate::decoder::{self, tiling, Decoder, DecoderUpdate};
diff --git a/src/widgets/image_page.rs b/src/widgets/image_page.rs
index c6101e5..d5fdf73 100644
--- a/src/widgets/image_page.rs
+++ b/src/widgets/image_page.rs
@@ -17,6 +17,10 @@
 //
 // SPDX-License-Identifier: GPL-3.0-or-later
 
+//! A widget that shows the image, a loading screen, or an error page
+//!
+//! This widget also handles showing the context menu.
+
 use crate::deps::*;
 use crate::widgets::LpImage;
 
diff --git a/src/widgets/image_view.rs b/src/widgets/image_view.rs
index 78dc948..5c1ad3b 100644
--- a/src/widgets/image_view.rs
+++ b/src/widgets/image_view.rs
@@ -17,6 +17,14 @@
 //
 // SPDX-License-Identifier: GPL-3.0-or-later
 
+//! A widget that shows the [`LpSlidingView`] and coordinates it's content
+//!
+//! This widget coordinates the content of [`LpSlidingView`] with the
+//! [`LpFileModel`]. It also handles input that changes the image.
+//!
+//! [`LpSlidingView`]: crate::widgets::LpSlidingView
+//! [`LpFileModel`]: crate::file_model::LpFileModel
+
 use crate::deps::*;
 use crate::file_model::LpFileModel;
 use crate::i18n::*;
diff --git a/src/widgets/sliding_view.rs b/src/widgets/sliding_view.rs
index 584082d..eed11f9 100644
--- a/src/widgets/sliding_view.rs
+++ b/src/widgets/sliding_view.rs
@@ -1,4 +1,4 @@
-//! Sliding view for images
+//! A sliding view widget for images
 //!
 //! This widget it similar to `AdwCarousel`.
 //! Currently, there is no swipe-gesture support since it's not working with