Update header comments on models

Author: Joey Lorich

EasyReader.xcodeproj/project.pbxproj

@@ -578,14 +578,14 @@
 		9DAC171D170A043200383722 /* Models */ = {
 			isa = PBXGroup;
 			children = (
+				8E7F81EE18D0BF8500BC50C2 /* CSBaseObject.h */,
+				8E7F81EF18D0BF8500BC50C2 /* CSBaseObject.m */,
 				0DE51FF618CF919900454E51 /* Feed.h */,
 				0DE51FF718CF919900454E51 /* Feed.m */,
 				0DE51FEF18CF911000454E51 /* FeedItem.h */,
 				0DE51FF018CF911000454E51 /* FeedItem.m */,
 				0DE51FF118CF911000454E51 /* User.h */,
 				0DE51FF218CF911000454E51 /* User.m */,
-				8E7F81EE18D0BF8500BC50C2 /* CSBaseObject.h */,
-				8E7F81EF18D0BF8500BC50C2 /* CSBaseObject.m */,
 			);
 			path = Models;
 			sourceTree = "<group>";

EasyReader/Application/Models/CSBaseObject.h

@@ -11,7 +11,23 @@
 #import "NSObject+CSNilAdditions.h"
 #import "NSString+Inflections.h"
 
+
+#pragma mark - CSBaseObject -
+
+/**
+ * A base for NSManagedObjects that represent objects in a remote API object
+ */
 @interface CSBaseObject : NSManagedObject
+
+
+#pragma mark - Instance creation from API Data helpers
+
+/*
+ * Creates or updates an object base on API data
+ *
+ * @param remoteObjectData the api data to update/create based on
+ */
 + (id)createOrUpdateFirstFromAPIData:(NSDictionary *)remoteObjectData;
 
+
 @end

EasyReader/Application/Models/Feed.h

@@ -12,13 +12,16 @@
 
 @class FeedItem, User;
 
+
+#pragma mark - Feed -
+
 /**
  * An RSS Feed
  */
 @interface Feed : CSBaseObject
 
 
-#pragma mark - Core Data Properties
+#pragma mark  - Core Data Properties
 
 /// This feed's icon
 @property (nonatomic, retain) NSString * icon;
@@ -39,28 +42,48 @@
 @property (nonatomic, retain) NSSet *feedItems;
 
 
-@end
-
+#pragma mark - API Methods
 
 /**
- * Core data generated accessor category
+ * Creates a new feed based on a given url
+ *
+ * @param url
+ * @param successBlock A block to be run on API call success
+ * @param failureBlock A block to be run on API call failure
  */
-@interface Feed (CoreDataGeneratedAccessors)
-
-- (void)addFeedItemsObject:(FeedItem *)value;
-- (void)removeFeedItemsObject:(FeedItem *)value;
-- (void)addFeedItems:(NSSet *)values;
-- (void)removeFeedItems:(NSSet *)values;
-
 + (void) createFeedWithUrl:(NSString *) url
                    success:(void(^)(NSDictionary *data))successBlock
                    failure:(void(^)(NSDictionary *data))failureBlock;
 
+/**
+ * Requests the default feeds list (called once on the first app run)
+ *
+ * @param successBlock A block to be run on API call success
+ * @param failureBlock A block to be run on API call failure
+ */
 + (void) requestDefaultFeedsWithSuccess:(void(^)(NSDictionary *data))successBlock
                                 failure:(void(^)(NSDictionary *data))failureBlock;
 
+/**
+ * Requests a list of feeds by name (search)
+ *
+ * @param successBlock A block to be run on API call success
+ * @param failureBlock A block to be run on API call failure
+ */
 + (void) requestFeedsByName:(NSString *) name
                     success:(void(^)(NSDictionary *data))successBlock
                     failure:(void(^)(NSDictionary *data))failureBlock;
 
 @end
+
+
+#pragma mark - Core Data Generated Accessors -
+
+@interface Feed (CoreDataGeneratedAccessors)
+
+- (void)addFeedItemsObject:(FeedItem *)value;
+- (void)removeFeedItemsObject:(FeedItem *)value;
+- (void)addFeedItems:(NSSet *)values;
+- (void)removeFeedItems:(NSSet *)values;
+
+@end

EasyReader/Application/Models/FeedItem.h

@@ -12,6 +12,9 @@
 
 @class Feed;
 
+
+#pragma mark - FeedItem -
+
 /**
  * A single feed item in a feed
  */
@@ -26,7 +29,7 @@
 /// The summary for this feed item
 @property (nonatomic, retain) NSString * summary;
 
-/// /// The time this feed item was updated
+/// The time this feed item was updated
 @property (nonatomic, retain) NSDate * updatedAt;
 
 /// The time this feed item's article was published

EasyReader/Application/Models/User.h

@@ -12,18 +12,38 @@
 
 @class Feed;
 
+#pragma mark - User -
+
+/**
+ * An EasyReader User generally one per project
+ */
 @interface User : CSBaseObject
 
+
+#pragma mark - Core Data Properties
+
+/// The users feeds
 @property (nonatomic, retain) NSSet *feeds;
+
+
+#pragma mark - Methods
+
+/**
+ * Gets the current user (a singleton shared user)
+ */
++ (User *)current;
+
+
 @end
 
+
+#pragma mark - Core Data Generated Accessors -
+
 @interface User (CoreDataGeneratedAccessors)
 
 - (void)addFeedsObject:(Feed *)value;
 - (void)removeFeedsObject:(Feed *)value;
 - (void)addFeeds:(NSSet *)values;
 - (void)removeFeeds:(NSSet *)values;
 
-+ (User *)current;
-
 @end