diff --git a/src/Transaction.h b/src/Transaction.h
index f9101cf49e..9e0f3f6678 100644
--- a/src/Transaction.h
+++ b/src/Transaction.h
@@ -1,6 +1,11 @@
 #ifndef __TRANSACTION__
 #define __TRANSACTION__
 
+//
+// Notes: this code contains legacy constructored sharedXYZ and setXYZ. The intent is for these functions to go away. Transactions
+// should now be constructed in JSON with. Use STObject::parseJson to obtain a binary version.
+//
+
 #include <vector>
 
 #include <boost/shared_ptr.hpp>