add docs to address PR feedback

Author: kantai

clarity/src/vm/database/clarity_db.rs

@@ -927,6 +927,14 @@ impl<'a> ClarityDatabase<'a> {
         }
     }
 
+    /// Return the block height for a given tenure height
+    ///   if the block information is queryable for the tenure height.
+    /// The block information for a given tenure height is queryable iff:
+    ///  * `tenure_height` falls in 2.x, and `tenure_height` < `current_height`
+    ///  * `tenure_height` falls in 3.x, and the first block of the tenure
+    ///    at `tenure_height` has a stacks block height less than `current_height`
+    ///
+    /// If the block information isn't queryable, return `Ok(None)`
     pub fn get_block_height_for_tenure_height(
         &mut self,
         tenure_height: u32,

stackslib/src/chainstate/nakamoto/coordinator/tests.rs

@@ -302,7 +302,7 @@ pub fn make_token_transfer(
     stx_transfer_signed
 }
 
-/// Make a token-transfer from a private key
+/// Make contract publish
 pub fn make_contract(
     chainstate: &mut StacksChainState,
     name: &str,

stackslib/src/clarity_vm/database/mod.rs

@@ -47,6 +47,9 @@ pub trait GetTenureStartId {
         tip: &StacksBlockId,
         tenure_id_consensus_hash: &ConsensusHash,
     ) -> Result<Option<TenureBlockId>, DBError>;
+    /// Return the StacksBlockId of the tenure start block for the
+    ///  tenure with coinbase height `coinbase_height` in the fork
+    ///  referenced by `tip`.
     fn get_tenure_block_id_at_cb_height(
         &self,
         tip: &StacksBlockId,