The repeted long-form docs for the timeout and retry arguments to all API-invoking methods are both too verbose and too terse: they don't include / reference examples, and they are wordy. By preference, they would point instead to a narrative page (built from e.g. docs/timeout_retry.rst) which would include comprehensive examples for them.