diff --git a/packages/horizon/contracts/data-service/extensions/DataServiceFeesStorage.sol b/packages/horizon/contracts/data-service/extensions/DataServiceFeesStorage.sol
index 03d9d55e5..30d1aa4ee 100644
--- a/packages/horizon/contracts/data-service/extensions/DataServiceFeesStorage.sol
+++ b/packages/horizon/contracts/data-service/extensions/DataServiceFeesStorage.sol
@@ -11,6 +11,7 @@ import { LinkedList } from "../../libraries/LinkedList.sol";
  * bugs. We may have an active bug bounty program.
  */
 abstract contract DataServiceFeesV1Storage {
+    /// @notice The amount of tokens locked in stake claims for each service provider
     mapping(address serviceProvider => uint256 tokens) public feesProvisionTracker;
 
     /// @notice List of all locked stake claims to be released to service providers
diff --git a/packages/subgraph-service/contracts/DisputeManager.sol b/packages/subgraph-service/contracts/DisputeManager.sol
index 44dc7c85d..a0019edfd 100644
--- a/packages/subgraph-service/contracts/DisputeManager.sol
+++ b/packages/subgraph-service/contracts/DisputeManager.sol
@@ -54,10 +54,10 @@ contract DisputeManager is
 
     // -- Constants --
 
-    // Maximum value for fisherman reward cut in PPM
+    /// @notice Maximum value for fisherman reward cut in PPM
     uint32 public constant MAX_FISHERMAN_REWARD_CUT = 500000; // 50%
 
-    // Minimum value for dispute deposit
+    /// @notice Minimum value for dispute deposit
     uint256 public constant MIN_DISPUTE_DEPOSIT = 1e18; // 1 GRT
 
     // -- Modifiers --