Improve docs and CI

Author: nhooyr

ci/fmt/entrypoint.sh

@@ -2,6 +2,10 @@
 
 source ci/lib.sh || exit 1
 
+unstaged_files() {
+	git ls-files --other --modified --exclude-standard
+}
+
 gen() {
 	# Unfortunately, this is the only way to ensure go.mod and go.sum are correct.
 	# See https://github.com/golang/go/issues/27005
@@ -25,7 +29,7 @@ if [[ $CI && $(unstaged_files) != "" ]]; then
 	echo
 	echo "files either need generation or are formatted incorrectly"
 	echo "please run:"
-	echo "./test.sh"
+	echo "./ci/run.sh"
 	echo
 	git status
 	exit 1

ci/lib.sh

@@ -12,7 +12,3 @@ export CI=${GITHUB_ACTION-}
 if [[ $CI ]]; then
 	export GOFLAGS=-mod=readonly
 fi
-
-unstaged_files() {
-	git ls-files --other --modified --exclude-standard
-}

dial.go

@@ -36,6 +36,8 @@ type DialOptions struct {
 // If an error occurs, the returned response may be non nil. However, you can only
 // read the first 1024 bytes of its body.
 //
+// You never need to close the resp.Body yourself.
+//
 // This function requires at least Go 1.12 to succeed as it uses a new feature
 // in net/http to perform WebSocket handshakes and get a writable body
 // from the transport. See https://github.com/golang/go/issues/26937#issuecomment-415855861