diff --git a/embassy/src/time/mod.rs b/embassy/src/time/mod.rs
index b19ab6dbb..4e9b5f592 100644
--- a/embassy/src/time/mod.rs
+++ b/embassy/src/time/mod.rs
@@ -1,6 +1,6 @@
-/// Time abstractions
-/// To use these abstractions, first call `set_clock` with an instance of an monotonic `Clock`.
-///
+//! Time abstractions
+//! To use these abstractions, first call `set_clock` with an instance of an [Clock](trait.Clock.html).
+//!
 mod duration;
 mod instant;
 mod traits;