diff --git a/apps/opencs/model/world/collectionbase.hpp b/apps/opencs/model/world/collectionbase.hpp
index 1a9b9deb7..1700a68ec 100644
--- a/apps/opencs/model/world/collectionbase.hpp
+++ b/apps/opencs/model/world/collectionbase.hpp
@@ -13,6 +13,11 @@ namespace CSMWorld
     struct RecordBase;
 
     /// \brief Base class for record collections
+    ///
+    /// \attention Modifying records through the interface does not update connected views.
+    /// Such modifications should be done through the table model interface instead unless no views
+    /// are connected to the model or special precautions have been taken to send update signals
+    /// manually.
     class CollectionBase
     {
             // not implemented