diff --git a/src/components/PackageIcon.tsx b/src/components/PackageIcon.tsx
index be6ef3a4e1..d206254c01 100644
--- a/src/components/PackageIcon.tsx
+++ b/src/components/PackageIcon.tsx
@@ -124,6 +124,8 @@ type PackageIconProps<T extends Metadata | PackageInstance> = {
  * @see Metadata
  * @see PackageInstance
  */
+// As of 2.0.5, the Metadata and PackageInstance types are currently equivalent. But include both in the union to make
+// the type signature more explicit.
 const PackageIcon = <T extends Metadata | PackageInstance>({
   packageOrMetadata,
   size,