diff --git a/src/repo/profile/mod.rs b/src/repo/profile/mod.rs
index 4736444..31861b9 100644
--- a/src/repo/profile/mod.rs
+++ b/src/repo/profile/mod.rs
@@ -1,3 +1,16 @@
+//! Evaluate profiles:
+//! ```rust
+//! use gentoo_utils::repo::Repo;
+//!
+//! let repo = Repo::new("/var/db/repos/gentoo");
+//! let profile = repo.evaluate_profile("default/linux/23.0")
+//!     .expect("failed to evaluate profile");
+//!
+//! for (key, value) in profile.make_defaults() {
+//!     println!("{key} = {value}");
+//! }
+//! ```
+
 use std::{
     collections::HashMap,
     fs::{self, File},