DOCS: Updated NDFrame.astype docs
I've had a couple situations where I've doubted if it's ``ser.astype('category')`` or ``ser.astype('categorical')`` and the doc string doesn't say. 

I think a few examples could help here + illustrate usage of the method. Also some cleanup of the doc string.