Improve ec2 module docs

I actually meant to fix the ec2 module docs to address [this issue](https://groups.google.com/forum/#!msg/ansible-project/otMeG_twb_8/TY9U5lpfd44J) but couldn't replicate it from the info in that thread. So instead while I was there I fixed these small docs things.