diff --git a/Sources/CoreMetrics/Metrics.swift b/Sources/CoreMetrics/Metrics.swift
index 4328087..433e90b 100644
--- a/Sources/CoreMetrics/Metrics.swift
+++ b/Sources/CoreMetrics/Metrics.swift
@@ -135,6 +135,9 @@ public class Recorder {
 
     /// Record a value.
     ///
+    /// Recording a value is meant to have "set" semantics, rather than "add" semantics.
+    /// This means that the value of this `Recorder` will match the passed in value, rather than accumulate and sum the values up.
+    ///
     /// - parameters:
     ///     - value: Value to record.
     @inlinable
@@ -144,6 +147,9 @@ public class Recorder {
 
     /// Record a value.
     ///
+    /// Recording a value is meant to have "set" semantics, rather than "add" semantics.
+    /// This means that the value of this `Recorder` will match the passed in value, rather than accumulate and sum the values up.
+    ///
     /// - parameters:
     ///     - value: Value to record.
     @inlinable