Added more docs about waiters

Added docs to both overview of clients and resources.
Merge pull request #44 from kyleknap/waiter-top-level-docs

Added more docs about waiters