Update API and docs

* Add documentation about GitHubIterator with an example
* Add documentation about the new logging introduced, with an example for
  setting it up
* Allow GitHubIterators to be properly refreshed.
* Add etag parameter to all of the API iter_* methods