README.md in eventbrite_sdk-3.1.6 vs README.md in eventbrite_sdk-3.2.0

@@ -147,9 +147,21 @@
 ```
 
 If you forget to provide the api_token key and `EventbriteSDK.token` is set, the request
 will fall-back on the global token for the action called.
 
+# Shallow resource list endpoints
+
+Some paginated lists are available at the base of the resource url, webhooks and 
+categories for example. The resources that have this trait will include the `Operations::List` module
+
+``` ruby
+
+# Retrieving
+
+categories = EventbriteSDK::Category.list.page(1) #=> GET /v3/categories/?page=1
+webhooks = EventbriteSDK::Webhook.list.page(1) #=> GET /v3/webhooks/?page=1
+```
 
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.