Minor doc changes.

I would personally replace all the "well?"s with better names, but I wasn't sure if you'd like that.  My main point is to fix a couple of grammar-o's and show a more specific return value.