Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: happy-eyeballs text is awkward #7433

Closed
jsoref opened this issue Jul 19, 2021 · 0 comments
Closed

doc: happy-eyeballs text is awkward #7433

jsoref opened this issue Jul 19, 2021 · 0 comments

Comments

@jsoref
Copy link
Contributor

@jsoref jsoref commented Jul 19, 2021

addresses for dual-stack hosts, preferring IPv6 first for the number of
milliseconds. If the IPv6 address cannot be connected to within that time then

... preferring IPv6 first for the number of milliseconds ...

is awkward.

I suspect it could be improved by changing preferring...first to giving IPv6 a head-start of ....

I'm familiar w/ happy-eyeballs technically, but the text here is confusing.

Happy eyeballs is an algorithm that attempts to connect to both IPv4 and IPv6

Beyond that, Happy Eyeballs should probably be capitalized as such. c.f.
The range of suggested useful values is limited. Happy Eyeballs RFC 6555 says

Unless there's a house style I haven't properly identified.

Possible text:

Happy Eyeballs is an algorithm that attempts to connect to both IPv4 and IPv6 addresses for dual-stack hosts, giving IPv6 a head-start of the specified number of milliseconds.

bagder added a commit that referenced this issue Aug 8, 2021
Reported-by: Josh Soref
Closes #7433
@bagder bagder closed this in a2e29f0 Aug 8, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

2 participants