diff --git a/pageserver/src/tenant/timeline.rs b/pageserver/src/tenant/timeline.rs
index 4e20320efd..6451518a2d 100644
--- a/pageserver/src/tenant/timeline.rs
+++ b/pageserver/src/tenant/timeline.rs
@@ -122,13 +122,13 @@ pub struct Timeline {
 
     pub(super) layers: RwLock<LayerMap<dyn PersistentLayer>>,
 
-    //
-    // Set of key ranges which should be covered by image layers to
-    // allow GC to remove old layers. BTreeMap key is start of range (inclusive),
-    // value - end of range (exclusive). This map is constructed by GC
-    // (when it can not remove layer because it is not covered by image layers)
-    // and used by compaction when it checks if new image layer should be created.
-    //
+    /// Set of key ranges which should be covered by image layers to
+    /// allow GC to remove old layers.
+    ///
+    /// BTreeMap key is start of range (inclusive),
+    /// value - end of range (exclusive). This map is constructed by GC
+    /// (when it can not remove layer because it is not covered by image layers)
+    /// and used by compaction when it checks if new image layer should be created.
     wanted_image_layers: Mutex<Option<BTreeMap<Key, Key>>>,
 
     last_freeze_at: AtomicLsn,