DOC: adding cosmo into modref and adjusting its __doc__ for proper rst formatting

I still think that it would be nice to convert Python codesnippets into proper doctests