diff --git a/crates/ui/src/prelude.rs b/crates/ui/src/prelude.rs
index 0a86b99f9f232927d9e92615adcf987997df7919..ee635e4d6b944d807034087ff1e4de2788505847 100644
--- a/crates/ui/src/prelude.rs
+++ b/crates/ui/src/prelude.rs
@@ -1,3 +1,5 @@
+//! The prelude of this crate. When building UI in zed you almost always want to import this.
+
 pub use gpui::prelude::*;
 pub use gpui::{
     div, px, relative, rems, AbsoluteLength, DefiniteLength, Div, Element, ElementId,
diff --git a/crates/ui/src/ui.rs b/crates/ui/src/ui.rs
index b074f10dad50b9e61d0ed69ca29f39687e54973e..e8ee51818ea963657aafc2cf1dfdd5f8dbd4668f 100644
--- a/crates/ui/src/ui.rs
+++ b/crates/ui/src/ui.rs
@@ -3,8 +3,6 @@
 //! This crate provides a set of UI primitives and components that are used to build all of the elements in Zed's UI.
 //!
 
-#![doc = include_str!("../docs/building-ui.md")]
-
 mod clickable;
 mod components;
 mod disableable;
diff --git a/crates/ui/src/utils.rs b/crates/ui/src/utils.rs
index 573a1333efcfa0169a84f52ce27e72838492c696..ed1fec690fc738be2bee5d621c7fc53f0c0f6b9e 100644
--- a/crates/ui/src/utils.rs
+++ b/crates/ui/src/utils.rs
@@ -1,3 +1,5 @@
+//! UI-related utilities (e.g. converting dates to a human-readable form).
+
 mod format_distance;
 
 pub use format_distance::*;