doc: fix some inconsistent use of hostname

[sam-github]

host names are DNS names, host addresses are IP addresses, and host
arguments and options can be either.

Checklist

• make -j4 test (UNIX), or vcbuild test (Windows) passes
• documentation is changed or added
• commit message follows commit guidelines

[nodejs-github-bot]

@sam-github build started: https://ci.nodejs.org/blue/organizations/jenkins/node-test-pull-request-lite-pipeline/detail/node-test-pull-request-lite-pipeline/1518/pipeline

[lpinca]

I think there reason why we decided to normalize everything to hostname (we did it in a "recent" PR if I remember correctly) is:

const url = new URL('http://127.0.0.1:8080/');

console.log(url.host); // => 127.0.0.1:8080
console.log(url.hostname); // => 127.0.0.1

[addaleax]

(I think the PR that @lpinca is referring to is #23572, just for context.)

[sam-github]

I agee with #23572, this is continuation of it. The DNS APIs changed there accept host names (and not addresses). Which isn't actually like URL parsing at all, since URls can have addresses or host names in the hostname field (not that that's relevant to these changes).

@lpinca perhaps you can comment more specifically on some of the changes I propose? I know its a mixture of changes, from fixing unclear docs, to actual typos, or just what I consider to be oddities in examples, so if there are specific ones you think don't make sense that would help.

Btw, I don't know what normalize means, but it is certainly not the case that all uses of host were replaced with hostname, see https://nodejs.org/api/net.html#net_server_listen_port_host_backlog_callback

[sam-github]

I think I addressed the comments, can I have a re-review?

[sam-github]

ci-lite: https://ci.nodejs.org/job/node-test-pull-request-lite-pipeline/1562/

[sam-github]

ci: https://ci.nodejs.org/job/node-test-pull-request/18477/

[Trott]

Landed in 3833d69.