Update docs

AsyncDisplayKit/ASCollectionView.h

@@ -52,11 +52,12 @@ NS_ASSUME_NONNULL_BEGIN
 @property (nonatomic, weak) id<ASCollectionDataSource> asyncDataSource;
 
 /**
- * Whether the view should block the main thread during the next layout pass while
- * any pending data is loaded. This is useful if you want to ensure that the next frame
- * that is composited with this view will have all the nodes.
+ * Tell the collection view that, during the next layoutSubviews pass, it should block the
+ * main thread and wait for all items to be up-to-date.
  *
- * This method must be called on the main thread.
+ * @discussion This is useful when you want to ensure that the user never sees an empty
+ * collection view. It is better to call this than to explicitly wait using `waitUntilAllUpdatesAreCommitted`
+ * because the collection view's size may not be correct until the layout pass.
  */
 - (void)waitForUpdatesDuringNextLayoutPass;
 

AsyncDisplayKit/ASTableView.h

@@ -48,11 +48,12 @@ NS_ASSUME_NONNULL_BEGIN
 - (instancetype)initWithFrame:(CGRect)frame style:(UITableViewStyle)style;
 
 /**
- * Whether the view should block the main thread for the initial data load.
+ * Tell the table view that, during the next layoutSubviews pass, it should block the
+ * main thread and wait for all rows to be up-to-date.
  *
- * If YES, the view will wait for the initial batch of nodes to be allocated and measured
- * for the first data load. This occurs during the first layout pass, or when -reloadData is
- * called, whichever comes first. Defaults to NO. This property must be accessed on the main thread.
+ * @discussion This is useful when you want to ensure that the user never sees an empty
+ * table view. It is better to call this than to explicitly wait using `waitUntilAllUpdatesAreCommitted`
+ * because the table view's size may not be correct until the layout pass.
  */
 - (void)waitForUpdatesDuringNextLayoutPass;