diff --git a/doc.go b/doc.go
index 3460b46b1..d63b5d83c 100644
--- a/doc.go
+++ b/doc.go
@@ -5,8 +5,6 @@
 //
 // The assert package provides a comprehensive set of assertion functions that tie in to the Go testing system.
 //
-// The http package contains tools to make it easier to test http activity using the Go testing system.
-//
 // The mock package provides a system by which it is possible to mock your objects and verify calls are happening as expected.
 //
 // The suite package provides a basic structure for using structs as testing suites, and methods on those structs as tests.  It includes setup/teardown functionality in the way of interfaces.
diff --git a/http/doc.go b/http/doc.go
index aad0e7422..7c800aa20 100644
--- a/http/doc.go
+++ b/http/doc.go
@@ -1,2 +1,2 @@
-// Deprecated: Use net/http/httptest instead.
+// Deprecated: Use [net/http/httptest] instead.
 package http
diff --git a/http/test_response_writer.go b/http/test_response_writer.go
index 7fe4fe59f..6744e1c74 100644
--- a/http/test_response_writer.go
+++ b/http/test_response_writer.go
@@ -4,7 +4,7 @@ import (
 	"net/http"
 )
 
-// Deprecated: Use https://pkg.go.dev/net/http/httptest instead.
+// Deprecated: Use [net/http/httptest] instead.
 type TestResponseWriter struct {
 
 	// StatusCode is the last int written by the call to WriteHeader(int)
@@ -17,7 +17,7 @@ type TestResponseWriter struct {
 	header http.Header
 }
 
-// Deprecated: Use https://pkg.go.dev/net/http/httptest instead.
+// Deprecated: Use [net/http/httptest] instead.
 func (rw *TestResponseWriter) Header() http.Header {
 
 	if rw.header == nil {
@@ -27,7 +27,7 @@ func (rw *TestResponseWriter) Header() http.Header {
 	return rw.header
 }
 
-// Deprecated: Use https://pkg.go.dev/net/http/httptest instead.
+// Deprecated: Use [net/http/httptest] instead.
 func (rw *TestResponseWriter) Write(bytes []byte) (int, error) {
 
 	// assume 200 success if no header has been set
@@ -43,7 +43,7 @@ func (rw *TestResponseWriter) Write(bytes []byte) (int, error) {
 
 }
 
-// Deprecated: Use https://pkg.go.dev/net/http/httptest instead.
+// Deprecated: Use [net/http/httptest] instead.
 func (rw *TestResponseWriter) WriteHeader(i int) {
 	rw.StatusCode = i
 }
diff --git a/http/test_round_tripper.go b/http/test_round_tripper.go
index 2802c075c..a0bdd7181 100644
--- a/http/test_round_tripper.go
+++ b/http/test_round_tripper.go
@@ -6,12 +6,12 @@ import (
 	"github.com/stretchr/testify/mock"
 )
 
-// Deprecated: Use https://pkg.go.dev/net/http/httptest instead.
+// Deprecated: Use [net/http/httptest] instead.
 type TestRoundTripper struct {
 	mock.Mock
 }
 
-// Deprecated: Use https://pkg.go.dev/net/http/httptest instead.
+// Deprecated: Use [net/http/httptest] instead.
 func (t *TestRoundTripper) RoundTrip(req *http.Request) (*http.Response, error) {
 	args := t.Called(req)
 	return args.Get(0).(*http.Response), args.Error(1)