In the README.md currently it says:

First we start the port:

      iex> child = {NimblePool, worker: {PortPool, :cat}, name: PortPool}
      iex> Supervisor.start_link([child], strategy: :one_for_one)

I believe this is confusing since what we are starting is a pool of ports synchronously not "the port".

In the following example in the README.md:

  First we start the connection:

      child = {NimblePool, worker: {HTTP1Pool, {:https, "elixir-lang.org", 443}}, name: HTTP1Pool}
      Supervisor.start_link([child], strategy: :one_for_one)

Here then below what it does it starts the pool which has :async worker initialization, so I think here also the
"the connection" should be changed.

This is why I opened this PR, I hope I'm not missing any details. Thanks for reviewing.