From fd0cfa411c43cb6c04dd5bae78e719ebd15da2e0 Mon Sep 17 00:00:00 2001 From: Edward Faulkner Date: Wed, 7 Aug 2024 14:50:14 -0400 Subject: [PATCH] wip --- text/0000-deprecate-target-action-support.md | 105 +++++++++++++++++++ 1 file changed, 105 insertions(+) create mode 100644 text/0000-deprecate-target-action-support.md diff --git a/text/0000-deprecate-target-action-support.md b/text/0000-deprecate-target-action-support.md new file mode 100644 index 0000000000..6795adf6f9 --- /dev/null +++ b/text/0000-deprecate-target-action-support.md @@ -0,0 +1,105 @@ +--- +stage: accepted +start-date: # In format YYYY-MM-DDT00:00:00.000Z +release-date: # In format YYYY-MM-DDT00:00:00.000Z +release-versions: +teams: # delete teams that aren't relevant + - cli + - data + - framework + - learning + - steering + - typescript +prs: + accepted: # Fill this in with the URL for the Proposal RFC PR +project-link: +suite: +--- + + + +<-- Replace "RFC title" with the title of your RFC --> +# Deprecate target action support + +## Summary + +Deprecate `send` and the corresponding target action support. + +## Motivation + +These are super-old patterns that nobody needs to use in new code. We've already deprecated the `{{action}}` modifier/helper, which was the primary way to interact with this system. + +## Detailed design + +Things this would target + +- `TargetActionSupport` mixin + - `triggerAction` +- `ActionHandler` mixin + - `send` method +- `ActionSupport` mixin + - `send` method + +> This is the bulk of the RFC. + +> Explain the design in enough detail for somebody +familiar with the framework to understand, and for somebody familiar with the +implementation to implement. This should get into specifics and corner-cases, +and include examples of how the feature is used. Any new terminology should be +defined here. + +> Please keep in mind any implications within the Ember ecosystem, such as: +> - Lint rules (ember-template-lint, eslint-plugin-ember) that should be added, modified or removed +> - Features that are replaced or made obsolete by this feature and should eventually be deprecated +> - Ember Inspector and debuggability +> - Server-side Rendering +> - Ember Engines +> - The Addon Ecosystem +> - IDE Support +> - Blueprints that should be added or modified + +## How we teach this + +> What names and terminology work best for these concepts and why? How is this +idea best presented? As a continuation of existing Ember patterns, or as a +wholly new one? + +> Would the acceptance of this proposal mean the Ember guides must be +re-organized or altered? Does it change how Ember is taught to new users +at any level? + +> How should this feature be introduced and taught to existing Ember +users? + +> Keep in mind the variety of learning materials: API docs, guides, blog posts, tutorials, etc. + +## Drawbacks + +> Why should we *not* do this? Please consider the impact on teaching Ember, +on the integration of this feature with other existing and planned features, +on the impact of the API churn on existing apps, etc. + +> There are tradeoffs to choosing any path, please attempt to identify them here. + +## Alternatives + +> What other designs have been considered? What is the impact of not doing this? + +> This section could also include prior art, that is, how other frameworks in the same domain have solved this problem. + +## Unresolved questions + +> Optional, but suggested for first drafts. What parts of the design are still +TBD?