f better docs

Author: TheBlueMatt

lightning/src/chain/channelmonitor.rs

@@ -58,12 +58,12 @@ use core::ops::Deref;
 use sync::Mutex;
 
 /// An update generated by the underlying Channel itself which contains some new information the
-/// ChannelMonitor should be made aware of.
+/// [`ChannelMonitor`] should be made aware of.
 ///
-/// Because these represent only a small number of updates to the underlying state, they are
-/// generally much smaller than a full [`ChannelMonitor`]. However, for large single commitment
-/// transaction updates (e.g. ones during which there are hundreds of HTLCs pending on the
-/// commitment transaction), a single update may reach upwards of 1 MiB in serialized size.
+/// Because this represents only a small number of updates to the underlying state, it is generally
+/// much smaller than a full [`ChannelMonitor`]. However, for large single commitment transaction
+/// updates (e.g. ones during which there are hundreds of HTLCs pending on the commitment
+/// transaction), a single update may reach upwards of 1 MiB in serialized size.
 #[cfg_attr(any(test, fuzzing, feature = "_test_utils"), derive(PartialEq))]
 #[derive(Clone)]
 #[must_use]