azcore/policy retry: missing documentation about handling of retry-after header

[serbrech]

azure-sdk-for-go/sdk/azcore/runtime/policy_retry.go

Lines 173 to 177 in b386adc

	// use the delay from retry-after if available
	delay := shared.RetryAfter(resp)
	if delay <= 0 {
	delay = calcDelay(options, try)
	}

I was surprised to see no mention of the handling of retry-after header by the client.
I had to look at the code to find the above code snippet.
This behavior is not documented in the RetryDelay option that can be set on the clients:

azure-sdk-for-go/sdk/azcore/policy/policy.go

Lines 84 to 87 in b386adc

	// RetryDelay specifies the initial amount of delay to use before retrying an operation.
	// The delay increases exponentially with each retry up to the maximum specified by MaxRetryDelay.
	// The default value is four seconds. A value less than zero means no delay between retries.
	RetryDelay time.Duration

[jhendrixMSFT]

Fixes will ship in the August release.