From 4fb4119f9c50e8305936366aa9708807f7b579c3 Mon Sep 17 00:00:00 2001
From: Levi McCallum <levi.mccallum@nfl.com>
Date: Sun, 11 Oct 2015 10:32:34 -0700
Subject: [PATCH] Clarify data controller subclass hooks

---
 AsyncDisplayKit/Details/ASDataController.mm | 47 ++++++++++-----------
 1 file changed, 23 insertions(+), 24 deletions(-)

diff --git a/AsyncDisplayKit/Details/ASDataController.mm b/AsyncDisplayKit/Details/ASDataController.mm
index 84e979b713..8ae2454c78 100644
--- a/AsyncDisplayKit/Details/ASDataController.mm
+++ b/AsyncDisplayKit/Details/ASDataController.mm
@@ -406,23 +406,6 @@ static void *kASSizingQueueContext = &kASSizingQueueContext;
   }];
 }
 
-#pragma mark - Initial & Reload Data Hooks (Subclass API)
-
-- (void)willPerformInitialDataLoading
-{
-  // Implemented by subclasses
-}
-
-- (void)prepareForReloadData
-{
-  // Implemented by subclasses
-}
-
-- (void)willReloadData
-{
-  // Implemented by subclasses
-}
-
 #pragma mark - Data Source Access (Calling _dataSource)
 
 /**
@@ -681,36 +664,52 @@ static void *kASSizingQueueContext = &kASSizingQueueContext;
   }];
 }
 
-#pragma mark - Section Insertion Hooks (Subclass API)
+
+#pragma mark - Backing store manipulation optional hooks (Subclass API)
+
+- (void)willPerformInitialDataLoading
+{
+  // Optional template hook for subclasses (See ASDataController+Subclasses.h)
+}
+
+- (void)prepareForReloadData
+{
+  // Optional template hook for subclasses (See ASDataController+Subclasses.h)
+}
+
+- (void)willReloadData
+{
+  // Optional template hook for subclasses (See ASDataController+Subclasses.h)
+}
 
 - (void)prepareInsertSections:(NSIndexSet *)sections
 {
-  // Implemented by subclass
+  // Optional template hook for subclasses (See ASDataController+Subclasses.h)
 }
 
 - (void)willInsertSections:(NSIndexSet *)sections
 {
-  // Implemented by subclass
+  // Optional template hook for subclasses (See ASDataController+Subclasses.h)
 }
 
 - (void)willDeleteSections:(NSIndexSet *)sections
 {
-  // Implemented by subclass
+  // Optional template hook for subclasses (See ASDataController+Subclasses.h)
 }
 
 - (void)prepareForReloadSections:(NSIndexSet *)sections
 {
-  // Implemented by subclass
+  // Optional template hook for subclasses (See ASDataController+Subclasses.h)
 }
 
 - (void)willReloadSections:(NSIndexSet *)sections
 {
-  // Implemented by subclass
+  // Optional template hook for subclasses (See ASDataController+Subclasses.h)
 }
 
 - (void)willMoveSection:(NSInteger)section toSection:(NSInteger)newSection
 {
-  // Implemented by subclass
+  // Optional template hook for subclasses (See ASDataController+Subclasses.h)
 }
 
 #pragma mark - Row Editing (External API)