add documentation for the 2 new retry options