f tweak Route/Path docs

Author: valentinewallace

lightning/src/routing/router.rs

@@ -279,11 +279,14 @@ impl_writeable_tlv_based!(BlindedTail, {
 	(8, intro_node_scid, required),
 });
 
-/// A path in a [`Route`] to the payment recipient.
+/// A path in a [`Route`] to the payment recipient. Must always be at least length one. While the
+/// maximum length of any given path is variable, keeping the length of any path less than or equal
+/// to 19 should currently ensure it is viable.
 #[derive(Clone, Debug, Hash, PartialEq, Eq)]
 pub struct Path {
-	/// The list of unblinded hops in this [`Path`]. May be empty if a blinded path is present,
-	/// otherwise the last hop is the destination and this must be at least length one.
+	/// The list of unblinded hops in this [`Path`], NOT INCLUDING our own. May be empty if a blinded
+	/// path is present, otherwise the last hop is the destination and this must be at least length
+	/// one.
 	pub hops: Vec<RouteHop>,
 	/// The blinded path at which this path terminates, if we're sending to one, and its metadata.
 	pub blinded_tail: Option<BlindedTail>,
@@ -293,11 +296,7 @@ pub struct Path {
 /// it can take multiple paths. Each path is composed of one or more hops through the network.
 #[derive(Clone, Hash, PartialEq, Eq)]
 pub struct Route {
-	/// The list of [`Path`]s taken for a single (potentially-)multi-part payment. Each entry
-	/// represents a list of hops, NOT INCLUDING our own, where the last hop is either the recipient
-	/// or a [`BlindedTail`] that hides the recipient's identity. Thus, [`Path::len`] must always be
-	/// at least length one. While the maximum length of any given path is variable, keeping the
-	/// length of any path less than or equal to 19 should currently ensure it is viable. If no
+	/// The list of [`Path`]s taken for a single (potentially-)multi-part payment. If no
 	/// [`BlindedTail`]s are present, then the pubkey of the last [`RouteHop`] in each path must be
 	/// the same.
 	pub paths: Vec<Path>,