Document batch and retry behaviour.
Add a note about performances.