 import UIKit
 
 public extension UICollectionView {
-	/// A convenient way to create and configue a UICollectionView with a CenteredCollectionViewFlowLayout.
+	/// A convenient way to create a UICollectionView and configue it with a CenteredCollectionViewFlowLayout.
 	///
-	///
-	/// - Parameter frame: <#frame description#>
-	/// - Returns: <#return value description#>
+	/// - Parameters:
+	///   - frame: The frame rectangle for the collection view, measured in points. The origin of the frame is relative to the superview in which you plan to add it. This frame is passed to the superclass during initialization.
+	///   - centeredCollectionViewFlowLayout: The `CenteredCollectionViewFlowLayout` for the `UICollectionView` to be configured with.
 	public convenience init(frame: CGRect = .zero, centeredCollectionViewFlowLayout: CenteredCollectionViewFlowLayout) {
 		self.init(frame: frame, collectionViewLayout: centeredCollectionViewFlowLayout)
 		decelerationRate = UIScrollViewDecelerationRateFast
 	}
 }
 
+/// A `UICollectionViewFlowLayout` that _pages_ and keeps its cells centered, resulting in the _"carousel effect"_ 🎡
 open class CenteredCollectionViewFlowLayout: UICollectionViewFlowLayout {
 	
 	private var lastCollectionViewSize: CGSize = CGSize.zero

		}
	}
	
	public func scrollToPage(index: Int, animated: Bool) {
		guard let collectionView = collectionView else { return }
		

		collectionView.setContentOffset(proposedContentOffset, animated: shouldAnimate)
	}
	
	/// Calculates the current centered page.
	public var currentCenteredPage: Int? {
		guard let collectionView = collectionView else { return nil }
		let currentCenteredPoint = CGPoint(x: collectionView.contentOffset.x + collectionView.bounds.width/2, y: collectionView.contentOffset.y + collectionView.bounds.height/2)
