Cosmology doc update to reflect functional interface deprecation
Change log update
fix for doctest failure
Typo fixing and text tweaking
Merge pull request #2507 from nhmc/cosmology_doc_update

Cosmology doc update after deprecating the functional interface