diff --git a/src/cargo/lib.rs b/src/cargo/lib.rs
index a88c4b2edd6..467f96baaff 100644
--- a/src/cargo/lib.rs
+++ b/src/cargo/lib.rs
@@ -45,9 +45,10 @@
 //! - [`util`]:
 //!   This directory contains generally-useful utility modules.
 //! - [`util::context`]:
-//!   This directory contains the config parser. It makes heavy use of
-//!   [serde](https://serde.rs/) to merge and translate config values. The
-//!   [`util::GlobalContext`] is usually accessed from the
+//!   This directory contains the global applicaton context.
+//!   This includes the config parser which makes heavy use of
+//!   [serde](https://serde.rs/) to merge and translate config values.
+//!   The [`util::GlobalContext`] is usually accessed from the
 //!   [`core::Workspace`]
 //!   though references to it are scattered around for more convenient access.
 //! - [`util::toml`]: