clarify operator=
diff --git a/include/json/value.h b/include/json/value.h
index cf9703b..a5bada9 100644
--- a/include/json/value.h
+++ b/include/json/value.h
@@ -255,7 +255,8 @@
   Value(const Value& other);
   ~Value();
 
-  // Deep copy, then swap(other).
+  /// Deep copy, then swap(other).
+  /// \note Over-write existing comments. To preserve comments, use #swapPayload().
   Value& operator=(Value other);
   /// Swap everything.
   void swap(Value& other);