catalog-model: deprecate compareEntityToRef

Signed-off-by: Johan Haals <johan.haals@gmail.com>

packages/catalog-model/api-report.md

@@ -66,7 +66,7 @@ export class CommonValidatorFunctions {
   static isValidUrl(value: unknown): boolean;
 }
 
-// @public
+// @public @deprecated
 export function compareEntityToRef(
   entity: Entity,
   ref: EntityRef | EntityName,

packages/catalog-model/src/entity/ref.ts

@@ -234,6 +234,7 @@ export function stringifyEntityRef(
  * @param context - An optional context of default kind and namespace, that apply
  *                to the ref if given
  * @returns True if matching, false otherwise
+ * @deprecated compare using stringifyEntityRef instead.
  */
 export function compareEntityToRef(
   entity: Entity,