doc: improve into(type, object) docstring

Thanks @talumbau
Merge pull request #450 from mrocklin/better-docstrings

Improve docstrings