[HttpClient] Reorganize the docs about the retry_failed option

[javiereguiluz]

I was trying to fix #19854 but first, I think we need to reorganize the docs about the retry_failed option.