- /// Persist a new channel's data. The data can be stored any way you want, but the identifier
- /// provided by LDK is the channel's outpoint (and it is up to you to maintain a correct
- /// mapping between the outpoint and the stored channel data). Note that you **must** persist
- /// every new monitor to disk.
+ /// Persist a new channel's data in response to a [`chain::Watch::watch_channel`] call. This is
+ /// called by [`ChannelManager`] for new channels, or may be called directly, e.g. on startup.
+ ///
+ /// The data can be stored any way you want, but the identifier provided by LDK is the
+ /// channel's outpoint (and it is up to you to maintain a correct mapping between the outpoint
+ /// and the stored channel data). Note that you **must** persist every new monitor to disk.