diff --git a/common/src/main/resources/reference.conf b/common/src/main/resources/reference.conf
index f1e4907274..25fc4832e5 100644
--- a/common/src/main/resources/reference.conf
+++ b/common/src/main/resources/reference.conf
@@ -196,13 +196,13 @@ node {
   # Max in-flight (requested but not yet processed) blocks during sync. Range: [50, 2000].
   maxPendingBlockSize = 500
 
-  # Number of validate sign threads, default availableProcessors
   # Number of validate sign threads, 0 = auto (availableProcessors)
   validateSignThreadNum = 0
 
   maxConnections = 30           # Maximum peer connections.
   minConnections = 8            # Minimum peer connections to maintain.
   minActiveConnections = 3      # Minimum active peer connections.
+  # Legacy alias `maxActiveNodesWithSameIp` is still accepted but deprecated
   maxConnectionsWithSameIp = 2  # Maximum peer connections per IP.
   maxHttpConnectNumber = 50     # Maximum HTTP connections.
   minParticipationRate = 0      # Minimum SR participation rate.
@@ -233,9 +233,9 @@ node {
   inactiveThreshold = 600       // seconds
   maxFastForwardNum = 4      # Number of SRs after the block-producing SR that a fast-forward node forwards blocks to.
 
-  # Legacy alias `maxActiveNodesWithSameIp` is still accepted from user config
-  # (see NodeConfig alias-fallback) but is intentionally NOT defaulted here —
-  # shipping it in reference.conf would always mask the modern `maxConnectionsWithSameIp`.
+  # Deprecated. Enables legacy MetricsUtil counters/histograms and registers
+  # the monitor gRPC service (MonitorApi) on the RPC server.
+  # This is independent of the Prometheus exporter configured under node.metrics.prometheus.
   metricsEnable = false
 
   # P2P protocol version settings.
@@ -453,7 +453,7 @@ node {
 ## Rate limiter config
 rate.limiter = {
   # Each HTTP servlet and gRPC method can have its own rate-limit strategy.
-  # Three blocking strategies are available:
+  # Three API rate-limit strategies are available:
   #   GlobalPreemptibleAdapter – limits maximum concurrent requests globally.
   #                              paramString = "permit=N" (N = max concurrent calls)
   #   QpsRateLimiterAdapter    – limits average QPS across all callers.