src/net/http/server.go | 5 +++++

diff --git a/src/net/http/server.go b/src/net/http/server.go
index bbaf5d2cc64ac5e051737f16d88ee22e36e73052..8d50ffc59908ceb15372bf6c6a799a373d072db2 100644
--- a/src/net/http/server.go
+++ b/src/net/http/server.go
@@ -2016,6 +2016,11 @@ 	// StateActive fires before the request has entered a handler
 	// and doesn't fire again until the request has been
 	// handled. After the request is handled, the state
 	// transitions to StateClosed, StateHijacked, or StateIdle.
+	// For HTTP/2, StateActive fires on the transition from zero
+	// to one active request, and only transitions away once all
+	// active requests are complete. That means that ConnState
+	// can not be used to do per-request work; ConnState only notes
+	// the overall state of the connection.
 	StateActive
 
 	// StateIdle represents a connection that has finished