NFC: extend docs to cover deep copy
@@ -76,7 +76,9 @@ import java.util.concurrent.CountDownLatch;
* On the topic of the thread safety of traits, whilst this class utilises LinkedHashMap, writes to
* this map only occur from within the handler thread. Meanwhile reads are served immutable copies
* of traits mitigating the risk of data races with the exception of clients of this library
- * modifying nested data structures after passing them to this library.
+ * modifying nested data structures after passing them to this library. This concern could be
+ * mitigated by deep rather than shallow copying (e.g. via de-serialiation and re-serialisation),
+ * however this would contribute a performance penalty.
*/
public class AnalyticsContext extends ValueMap {
