add documentation on how retry works