producer: permit throttling max messages per request

Related to #233
producer: clarify documentation around Flush*
Merge pull request #235 from Shopify/max-messages-per-request

producer: permit throttling max messages per request