diff --git a/clientcfg/client.go b/clientcfg/client.go
index e80bda5..918f53d 100644
--- a/clientcfg/client.go
+++ b/clientcfg/client.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package clientcfg
 
 import (
diff --git a/datapoint/cast.go b/datapoint/cast.go
index 0e93572..b1d9719 100644
--- a/datapoint/cast.go
+++ b/datapoint/cast.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package datapoint
 
 import (
diff --git a/datapoint/dplocal/local.go b/datapoint/dplocal/local.go
index 8f050d0..6bc6b29 100644
--- a/datapoint/dplocal/local.go
+++ b/datapoint/dplocal/local.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package dplocal
 
 import (
diff --git a/datapoint/dpsink/counter.go b/datapoint/dpsink/counter.go
index 3f85a20..e317c11 100644
--- a/datapoint/dpsink/counter.go
+++ b/datapoint/dpsink/counter.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package dpsink
 
 import (
diff --git a/datapoint/dptest/basicsink.go b/datapoint/dptest/basicsink.go
index 0a922bd..a387eec 100644
--- a/datapoint/dptest/basicsink.go
+++ b/datapoint/dptest/basicsink.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package dptest
 
 import (
diff --git a/dataunit/dataunit.go b/dataunit/dataunit.go
index af5f907..735aa20 100644
--- a/dataunit/dataunit.go
+++ b/dataunit/dataunit.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package dataunit
 
 // Size represents a measurement of data and can return that measurement
diff --git a/disco/disco.go b/disco/disco.go
index 4bf7d35..9d97272 100644
--- a/disco/disco.go
+++ b/disco/disco.go
@@ -1,3 +1,5 @@
+// Deprecated: this package is no longer supported.
+//
 //nolint:gocritic
 package disco
 
diff --git a/distconf/bool.go b/distconf/bool.go
index b2b2299..08ad1dc 100644
--- a/distconf/bool.go
+++ b/distconf/bool.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package distconf
 
 import (
diff --git a/env/env.go b/env/env.go
index cdab085..8bd35bd 100644
--- a/env/env.go
+++ b/env/env.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package env
 
 import (
diff --git a/errors/analyze.go b/errors/analyze.go
index a8fff56..07fc233 100644
--- a/errors/analyze.go
+++ b/errors/analyze.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package errors
 
 import (
diff --git a/event/event.go b/event/event.go
index fd788c7..92ca904 100644
--- a/event/event.go
+++ b/event/event.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package event
 
 import (
diff --git a/eventcounter/eventcounter.go b/eventcounter/eventcounter.go
index 320ff1d..4fcea3e 100644
--- a/eventcounter/eventcounter.go
+++ b/eventcounter/eventcounter.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package eventcounter
 
 import (
diff --git a/explorable/explorable.go b/explorable/explorable.go
index c54f4e8..7356508 100644
--- a/explorable/explorable.go
+++ b/explorable/explorable.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package explorable
 
 import (
diff --git a/expvar2/handler.go b/expvar2/handler.go
index 08bbf6c..d586747 100644
--- a/expvar2/handler.go
+++ b/expvar2/handler.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package expvar2
 
 import (
diff --git a/go-metrics/exporter.go b/go-metrics/exporter.go
index eace6f5..a74f65f 100644
--- a/go-metrics/exporter.go
+++ b/go-metrics/exporter.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package go_metrics
 
 import (
diff --git a/gojavahash/gojavahash.go b/gojavahash/gojavahash.go
index b0b51d0..857d16e 100644
--- a/gojavahash/gojavahash.go
+++ b/gojavahash/gojavahash.go
@@ -1,6 +1,7 @@
 // Package gojavahash implements a ServerSelector for gomemcache that provides
 // hashing that's compatible with SpyMemcached's native (e.g. java) hashing.
 // This is based very closely on the excellent https://github.com/thatguystone/gomcketama
+// Deprecated: this package is no longer supported.
 package gojavahash
 
 import (
diff --git a/httpdebug/pprof14.go b/httpdebug/pprof14.go
index 6ef28da..a77f665 100644
--- a/httpdebug/pprof14.go
+++ b/httpdebug/pprof14.go
@@ -1,5 +1,7 @@
+//go:build !go1.5
 // +build !go1.5
 
+// Deprecated: this package is no longer supported.
 package httpdebug
 
 import (
diff --git a/log/channel.go b/log/channel.go
index 74914c9..bafbda4 100644
--- a/log/channel.go
+++ b/log/channel.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package log
 
 // ChannelLogger creates a logger that sends log messages to a channel.  It's useful for testing and buffering
diff --git a/logkey/keys.go b/logkey/keys.go
index 367af92..26218fe 100644
--- a/logkey/keys.go
+++ b/logkey/keys.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package logkey
 
 import "github.com/signalfx/golib/v3/log"
diff --git a/logsink/logsink.go b/logsink/logsink.go
index eac212e..ccd6352 100644
--- a/logsink/logsink.go
+++ b/logsink/logsink.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package logsink
 
 import (
diff --git a/maestro/load.go b/maestro/load.go
index c03ad83..bfdb889 100644
--- a/maestro/load.go
+++ b/maestro/load.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package maestro
 
 import (
diff --git a/metadata/aws/ec2metadata/ec2.go b/metadata/aws/ec2metadata/ec2.go
index 8c98d26..ded4501 100644
--- a/metadata/aws/ec2metadata/ec2.go
+++ b/metadata/aws/ec2metadata/ec2.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package ec2metadata
 
 import (
diff --git a/metadata/hostmetadata/host.go b/metadata/hostmetadata/host.go
index 271f37c..db9780d 100644
--- a/metadata/hostmetadata/host.go
+++ b/metadata/hostmetadata/host.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package hostmetadata
 
 import (
diff --git a/nettest/tcpport.go b/nettest/tcpport.go
index 2c121ea..dd1223e 100644
--- a/nettest/tcpport.go
+++ b/nettest/tcpport.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package nettest
 
 import (
diff --git a/pointer/pointer.go b/pointer/pointer.go
index d3067b2..3608f5a 100644
--- a/pointer/pointer.go
+++ b/pointer/pointer.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package pointer
 
 import (
diff --git a/reportsha/reportsha.go b/reportsha/reportsha.go
index 9cd9f49..55fb466 100644
--- a/reportsha/reportsha.go
+++ b/reportsha/reportsha.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package reportsha
 
 import (
diff --git a/safeexec/safeexec.go b/safeexec/safeexec.go
index dd73002..0afbf7a 100644
--- a/safeexec/safeexec.go
+++ b/safeexec/safeexec.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package safeexec
 
 import (
diff --git a/sfxclient/cumulativebucket.go b/sfxclient/cumulativebucket.go
index 3fde794..41271c1 100644
--- a/sfxclient/cumulativebucket.go
+++ b/sfxclient/cumulativebucket.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package sfxclient
 
 import (
diff --git a/sfxclient/spanfilter/spanfilter.go b/sfxclient/spanfilter/spanfilter.go
index 213fb4b..02f7d49 100644
--- a/sfxclient/spanfilter/spanfilter.go
+++ b/sfxclient/spanfilter/spanfilter.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package spanfilter
 
 import (
diff --git a/sfxtest/sfxtest.go b/sfxtest/sfxtest.go
index be94968..9ca2b2a 100644
--- a/sfxtest/sfxtest.go
+++ b/sfxtest/sfxtest.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package sfxtest
 
 import "sync"
diff --git a/timekeeper/timekeeper.go b/timekeeper/timekeeper.go
index e1f6b36..4db8e79 100644
--- a/timekeeper/timekeeper.go
+++ b/timekeeper/timekeeper.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package timekeeper
 
 import "time"
diff --git a/timekeeper/timekeepertest/timekeepertest.go b/timekeeper/timekeepertest/timekeepertest.go
index 55f852d..473a22c 100644
--- a/timekeeper/timekeepertest/timekeepertest.go
+++ b/timekeeper/timekeepertest/timekeepertest.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package timekeepertest
 
 import (
diff --git a/trace/format/format.go b/trace/format/format.go
index dc5d44b..19e2a3f 100644
--- a/trace/format/format.go
+++ b/trace/format/format.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package traceformat
 
 import "github.com/signalfx/golib/v3/trace"
diff --git a/trace/trace.go b/trace/trace.go
index 53c6cce..6750bfd 100644
--- a/trace/trace.go
+++ b/trace/trace.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package trace
 
 import (
diff --git a/trace/translator/batcher.go b/trace/translator/batcher.go
index 14a5811..9e30113 100644
--- a/trace/translator/batcher.go
+++ b/trace/translator/batcher.go
@@ -12,6 +12,7 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
+// Deprecated: this package is no longer supported.
 package translator
 
 import (
diff --git a/web/bucketreqcounter.go b/web/bucketreqcounter.go
index a920b61..e41e4d1 100644
--- a/web/bucketreqcounter.go
+++ b/web/bucketreqcounter.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package web
 
 import (
diff --git a/zkplus/builder.go b/zkplus/builder.go
index 71b6134..d74607e 100644
--- a/zkplus/builder.go
+++ b/zkplus/builder.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package zkplus
 
 import (
diff --git a/zkplus/zktest/zktest.go b/zkplus/zktest/zktest.go
index cce3e09..ce62f15 100644
--- a/zkplus/zktest/zktest.go
+++ b/zkplus/zktest/zktest.go
@@ -1,3 +1,4 @@
+// Deprecated: this package is no longer supported.
 package zktest
 
 import (