clarify docs

Author: johncantrell97

src/transport/message_handler.rs

@@ -17,9 +17,10 @@ use std::sync::{Arc, Mutex};
 
 const LSPS_FEATURE_BIT: usize = 729;
 
-/// A trait used to implement a specific LSPS protocol
+/// A trait used to implement a specific LSPS protocol.
+///
 /// The messages the protocol uses need to be able to be mapped
-/// from and into LSPSMessages.
+/// from and into [`LSPSMessage`].
 pub(crate) trait ProtocolMessageHandler {
 	type ProtocolMessage: TryFrom<LSPSMessage> + Into<LSPSMessage>;
 	const PROTOCOL_NUMBER: Option<u16>;
@@ -29,14 +30,19 @@ pub(crate) trait ProtocolMessageHandler {
 	) -> Result<(), LightningError>;
 }
 
-/// Configuration for the LSPManager
-/// Allows end-user to configure the behavior of the client
+/// A configuration for [`LSPManager`].
+///
+/// Allows end-user to configure options for both client and server
+/// usage of the [`LSPManager`].
 pub struct LSPConfig {
-	/// whether or not you intend to provide services
+	/// Indicates whether or not you intend to provide services.
 	is_lsp: bool,
 }
 
-/// The main interface into LSP functionality
+/// The main interface into LSP functionality.
+///
+/// Should be used as a [`CustomMessageHandler`] for your
+/// [`lightning::ln::peer_handler::PeerManager`]'s [`lightning::ln::peer_handler::MessageHandler`].
 pub struct LSPManager<ES: Deref>
 where
 	ES::Target: EntropySource,
@@ -53,7 +59,7 @@ where
 {
 	/// Constructor for the LSPManager
 	///
-	/// Sets up all required protocol message handlers based on configuration passed in
+	/// Sets up the required protocol message handlers based on the given [`LSPConfig`].
 	pub fn new(entropy_source: ES, config: LSPConfig) -> Self {
 		let pending_messages = Arc::new(Mutex::new(vec![]));