improve README and add CBP support for Triggers

Author: fbvilela

README.md

@@ -189,6 +189,17 @@ client.tickets.all! do |resource, page_number|
 end
 ```
 
+### Cursor Based Pagination
+
+A few endpoints related to organizations, tickets, triggers and groups will now make use of cursor based pagination by default.
+It is also recommended to use CBP whenever [the Zendesk developer documentation](https://developer.zendesk.com/api-reference) says it's supported.
+Pass `page[size]=number` in the parameters to attempt a CBP request, like the example below:
+
+```ruby
+client.connection.get('/api/v2/suspended_tickets', page: { size: 100 }).body
+{"suspended_tickets"=>[...], "meta"=>{"has_more"=>true, "after_cursor"=>" ... ", "before_cursor"=>nil}, "links"=>{"prev"=>nil, "next"=>"..."}}
+```
+
 ### Callbacks
 
 Callbacks can be added to the `ZendeskAPI::Client` instance and will be called (with the response env) after all response middleware on a successful request.

lib/zendesk_api/resources.rb

@@ -604,6 +604,7 @@ class Trigger < Rule
     include Conditions
     include Actions
 
+    CBP_ACTIONS = [/triggers$/, %r{triggers/active$}].freeze
     has :execution, :class => RuleExecution
   end
 

spec/live/cbp_support_spec.rb

@@ -41,4 +41,18 @@
       end
     end
   end
+
+  describe ZendeskAPI::Trigger do
+    describe '/triggers' do
+      it_behaves_like 'an endpoint that supports CBP' do
+        let(:collection) { client.triggers }
+      end
+    end
+
+    describe '/triggers/active' do
+      it_behaves_like 'an endpoint that supports CBP' do
+        let(:collection) { client.triggers.active }
+      end
+    end
+  end
 end