Re: [whatwg/fetch] Elaborate on obtaining a connection (#1245)

@annevk commented on this pull request.



> @@ -2204,6 +2204,39 @@ unset or <a for=request>keepalive</a> is false, <a lt=terminated for=fetch>termi
 <a for="fetch group">fetch record</a>'s <a for="fetch record">fetch</a>.
 
 
+<h3 id=resolving-domains>Resolving domains</h3>
+
+<p>To <dfn>resolve a domain</dfn>, given a <a for=/>domain</a> <var>domain</var> and a
+<a for=/>network partition key</a> <var>key</var>, perform an <a>implementation-defined</a>
+operation to turn <var>domain</var> into a <a for=/>set</a> of one or more
+<a for=/>IP addresses</a>. If this operation succeeds, return the <a for=/>set</a> of
+<a for=/>IP addresses</a>. If it fails, return failure. The results of this operation may be cached.
+If they are cached, <var>key</var> must be used as part of the cache key.

@MattMenke2 FWIW, I'd be happy to explain more or accept patches that explain more of it, but as I understand it from @sleevi that would be quite a bit of effort and it's not clear it'll help solve a problem. But we do need some basics written down for the rest of the things to make sense and fit together. In general though I'd say that the style is the opposite of what you suggest, in that we do try to cover all the details.

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/whatwg/fetch/pull/1245#discussion_r644821695