Tweak documentation in BestBlock to be a bit more clear

Author: TheBlueMatt

lightning/src/chain/mod.rs

@@ -38,15 +38,16 @@ pub struct BestBlock {
 }
 
 impl BestBlock {
-	/// Returns the best block from the genesis of the given network.
+	/// Constructs a `BestBlock` that represents the genesis block at height 0 of the given
+	/// network.
 	pub fn from_genesis(network: Network) -> Self {
 		BestBlock {
 			block_hash: genesis_block(network).header.block_hash(),
 			height: 0,
 		}
 	}
 
-	/// Returns the best block as identified by the given block hash and height.
+	/// Returns a `BestBlock` as identified by the given block hash and height.
 	pub fn new(block_hash: BlockHash, height: u32) -> Self {
 		BestBlock { block_hash, height }
 	}