diff --git a/Source/IGListAdapter.h b/Source/IGListAdapter.h
index 73773508..d99c5e96 100644
--- a/Source/IGListAdapter.h
+++ b/Source/IGListAdapter.h
@@ -262,8 +262,20 @@ NS_SWIFT_NAME(ListAdapter)
 - (CGSize)sizeForSupplementaryViewOfKind:(NSString *)elementKind
                              atIndexPath:(NSIndexPath *)indexPath;
 
+/**
+ Adds a listener to the list adapter.
+
+ @param updateListener The object conforming to the `IGListAdapterUpdateListener` protocol.
+
+ @note Listeners are held weakly so there is no need to call `-[IGListAdapter removeUpdateListener:]` on `dealloc`.
+ */
 - (void)addUpdateListener:(id<IGListAdapterUpdateListener>)updateListener;
 
+/**
+ Removes a listener from the list adapter.
+
+ @param updateListener The object conforming to the `IGListAdapterUpdateListener` protocol.
+ */
 - (void)removeUpdateListener:(id<IGListAdapterUpdateListener>)updateListener;
 
 /**