From 69ba41d26b0f8a3014042f46523fb6ba8509b6a4 Mon Sep 17 00:00:00 2001 From: Peter Wagenet Date: Fri, 13 Jun 2025 12:53:50 -0700 Subject: [PATCH] Add Deprecate Comparable --- text/1113-deprecate-comparable.md | 66 +++++++++++++++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 text/1113-deprecate-comparable.md diff --git a/text/1113-deprecate-comparable.md b/text/1113-deprecate-comparable.md new file mode 100644 index 0000000000..8ced06de17 --- /dev/null +++ b/text/1113-deprecate-comparable.md @@ -0,0 +1,66 @@ +--- +stage: accepted +start-date: 2025-06-13T00:00:00.000Z +release-date: +release-versions: +teams: # delete teams that aren't relevant + - cli + - data + - framework + - learning + - steering + - typescript +prs: + accepted: https://github.com/emberjs/rfcs/pull/1113 +project-link: +--- + + + +# Deprecating the `Comparable` Mixin + +## Summary + +Deprecate the `Comparable` Mixin. + +## Motivation + +For a while now, Ember has not recommended the use of Mixins. In order to fully +deprecate Mixins, we need to deprecate all existing Mixins of which `Comparable` is one. + +## Transition Path + +None. This will be removed without replacement. + +## Exploration + +To validate this deprecation, I've tried removing the `Comparable` Mixin from Ember.js in this PR: +https://github.com/emberjs/ember.js/pull/20924 + +## How We Teach This + +We should remove all references from the guides. + +## Drawbacks + +Some users probably rely on this functionality. However, it's almost certainly +something that we don't need to keep in Ember itself. + +## Alternatives + +* Convert `Comparable` to a class decorator-style mixin. + +## Unresolved questions + +None \ No newline at end of file