f missing docs and move inline

Author: TheBlueMatt

lightning/src/routing/scoring.rs

@@ -998,14 +998,14 @@ const PRECISION_LOWER_BOUND_DENOMINATOR: u64 = approx::LOWER_BITS_BOUND;
 const AMOUNT_PENALTY_DIVISOR: u64 = 1 << 20;
 const BASE_AMOUNT_PENALTY_DIVISOR: u64 = 1 << 30;
 
-#[inline(always)]
 /// Given liquidity bounds, calculates the success probability (in the form of a numerator and
 /// denominator) of an HTLC. This is a key assumption in our scoring models.
 ///
 /// Must not return a numerator or denominator greater than 2^31 for arguments less than 2^31.
-
-/// min_zero_implies_no_successes signals that an `amount_msat` of 0 means we've not (recently)
-/// seen an HTLC successfully complete over this channel.
+///
+/// min_zero_implies_no_successes signals that a `min_liquidity_msat` of 0 means we've not
+/// (recently) seen an HTLC successfully complete over this channel.
+#[inline(always)]
 fn success_probability(
 	min_liquidity_msat: u64, amount_msat: u64, max_liquidity_msat: u64, _capacity_msat: u64,
 	_params: &ProbabilisticScoringFeeParameters, _min_zero_implies_no_successes: bool,