 }
 
 public class FeedController <T:FeedItem> : FeedControllerGeneric{
+    
+    ///The items in the feed.
     private(set) public var items: [T]! = []
     public weak var delegate: FeedKitControllerDelegate?
-    //private(set) var  feedType: FeedKitType!
     private(set) var cachePreferences: CachePreferences
     public var cache: FeedCache<T>?
+    
+    ///The section in a UITableView or UICollectionView that the Feed Controller corresponds to.
     let section: Int!
-    
+
+    
+    /**
+     Initialize the Feed Controller
+     
+     parameter cachePreferences: The cache preferences.
+     parameter section: The section of the tableview or collection view that the controller corresponds to.
+     */
     public init(cachePreferences: CachePreferences, section: Int){
         self.section = section
         self.cachePreferences = cachePreferences

    
    /**
     Insert an item. This can be useful when rearranging items, e.g. if the user is manually arranging items in a tableview, we can use these to keep
     the FeedKit items in the correct position
     
     - parameter item: The item to be inserted
     - parameter atIndex: The index at which to insert the item
    */
    public func insertItem(item: T, atIndex index : Int) {
        items.insert(item, atIndex: index)

    
    /**
     Remove an item. This can be useful when rearranging items, e.g. if the user is manually arranging items in a tableview, we can use these to keep
     the FeedKit items in the correct position.
     
     - parameter index: the index of the item to be removed.
    */
    public func removeItemAtIndex(index: Int) {
        items.removeAtIndex(index)
