diff --git a/contracts/Proofs.sol b/contracts/Proofs.sol
index 6a6c736..399f83a 100644
--- a/contracts/Proofs.sol
+++ b/contracts/Proofs.sol
@@ -39,6 +39,10 @@ contract Proofs {
     markers[id] = uint(blockhash(block.number - 1)) % period;
   }
 
+  // Check whether a proof is required at the time of the block with the
+  // specified block number. A proof has to be submitted within the proof
+  // timeout for it to be valid. Whether a proof is required is determined
+  // randomly, but on average it is once every proof period.
   function _isProofRequired(
     bytes32 id,
     uint blocknumber
diff --git a/contracts/Storage.sol b/contracts/Storage.sol
index 0d62748..6e1ab5d 100644
--- a/contracts/Storage.sol
+++ b/contracts/Storage.sol
@@ -69,10 +69,6 @@ contract Storage is Contracts, Proofs {
     return _missed(contractId);
   }
 
-  // Check whether a proof is required at the time of the block with the
-  // specified block number. A proof has to be submitted within the proof
-  // timeout for it to be valid. Whether a proof is required is determined
-  // randomly, but on average it is once every proof period.
   function isProofRequired(
     bytes32 contractId,
     uint blocknumber
diff --git a/contracts/TestContracts.sol b/contracts/TestContracts.sol
index 9916ceb..b8a3c7c 100644
--- a/contracts/TestContracts.sol
+++ b/contracts/TestContracts.sol
@@ -3,6 +3,7 @@ pragma solidity ^0.8.0;
 
 import "./Contracts.sol";
 
+// exposes internal functions of Contracts for testing
 contract TestContracts is Contracts {
 
   function newContract(