Documentation changes and small refactoring

Opening this pull request and closing [pull request #2](https://github.com/rdwilliamson/aws/pull/2).

The changes here contain
* 1 small fix;
* some refactoring; and,
* much documentation.