bpo-39128: Added algorithm description (GH-18624)

GH- [bpo-39128](https://bugs.python.org/issue39128): happy eyeballs description

GH- [3.9] 39128 - happy eyeballs description (GH-18624)
GH- [3.8] 39128 - happy eyeballs description (GH-18624)

https://bugs.python.org/issue39128
(cherry picked from commit 8af4712a16e4b7d1b60f1faec13cd7a88da95f6a)

Co-authored-by: idomic <michael.ido@gmail.com>

diff --git a/Doc/library/asyncio-eventloop.rst b/Doc/library/asyncio-eventloop.rst
index 4ea8521eb0bf3614bb73512749390a5f57421e25..9022993e619a59c8c021daa3899e36f72abfef53 100644 (file)
--- a/Doc/library/asyncio-eventloop.rst
+++ b/Doc/library/asyncio-eventloop.rst
@@ -439,6 +439,17 @@ Opening network connections
 
       Added the *happy_eyeballs_delay* and *interleave* parameters.
 
+      Happy Eyeballs Algorithm: Success with Dual-Stack Hosts.
+      When a server's IPv4 path and protocol are working, but the server's
+      IPv6 path and protocol are not working, a dual-stack client
+      application experiences significant connection delay compared to an
+      IPv4-only client.  This is undesirable because it causes the dual-
+      stack client to have a worse user experience.  This document
+      specifies requirements for algorithms that reduce this user-visible
+      delay and provides an algorithm.
+
+      For more information: https://tools.ietf.org/html/rfc6555
+
    .. versionadded:: 3.7
 
       The *ssl_handshake_timeout* parameter.