[Doc] Add APIServer retry to doc

[machichima]

Search before asking

• I had searched in the issues and found no similar feature requirement.

Description

We added retry feature in APIServer V1 in #3551, we should document this behavior

Use case

No response

Related issues

Follow up #3551

Are you willing to submit a PR?

• Yes I am willing to submit a PR!

[dentiny]

@machichima Do you think the logic could be shared between v1 and v2?

[machichima]

@machichima Do you think the logic could be shared between v1 and v2?

Yes, I think so. But in V1, I wrap the retry logic in executeRequest, which this part is not independently extractable.

I think what V2 did now is better by creating a separate retryRoundTripper. I would suggest to share the retryRoundTripper from V2 to V1 is it is needed.

@dentiny WDYT?

[machichima]

Besides the retry logic, I think the constants and config struct can indeed share between V1 and V2

[dentiny]

I would suggest to share the retryRoundTripper from V2 to V1 is it is needed.

I like the idea, but haven't check the compatibility.

I think the constants and config struct can indeed share between V1 and V2

I think so; I don't divergence / difference for retry logic between these two versions

[dentiny]

Feel free to tag my review for the documentation PR, thank you!