changed docs to reflect method changes, improved docs on earlier method change too
changed docs to reflect method changes, improved docs on earlier method change too

dnkoutso/Core,AdamCampbell/Core,k0nserv/Core,gabro/Core,dacaiguoguogmail/Core,brianmichel/Core,CocoaPods/Core,Ashton-W/Core