finished frist draft api doc for the collection class.