diff --git a/crates/ui/src/prelude.rs b/crates/ui/src/prelude.rs
index 0a86b99f9f..ee635e4d6b 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 b074f10dad..e8ee51818e 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 573a1333ef..ed1fec690f 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::*;