Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document new and improved helper functions experience #1881

Open
jenweber opened this issue Dec 5, 2022 · 1 comment
Open

Document new and improved helper functions experience #1881

jenweber opened this issue Dec 5, 2022 · 1 comment

Comments

@jenweber
Copy link
Contributor

jenweber commented Dec 5, 2022

Excellent news - helpers are now much more intuitive to use in Ember! The feature shipped quietly, and now that it's had some additional testing, we should document it and invite all our developers to start using it!

This issue blocks advancing this RFC: emberjs/rfcs#866

How to help:

  • Read the RFC, https://rfcs.emberjs.com/id/0756-helper-default-manager
    • Especially review the "How we teach this" section of the RFC
  • Update the page on helpers as described in the RFC. When possible, re-use examples from the RFC.
  • Find all the additional places where helper is mentioned in the guides/release folder of this project
  • Update those sections too, or open new tickets for them if they are not quick to fix

Excerpt from "how we teach this":

On the Helper Functions page, We'll want to insert a section early on about how helpers can be "local" to or defined on components and controllers. Then, once there have been examples of the local/private helper, the existing content can continue to talk about the "global helper" -- explicitly differentiating between the local/private helper, rather then retaining the general "Helper Function" title as "Helper Functions" are all of these, rather than just the globally defines ones.

@jenweber jenweber changed the title WIP Document new and improved helper functions experience Document new and improved helper functions experience Dec 5, 2022
@SkoebaSteve
Copy link

As discussed I'll take this and will create a PR by next week, thanks for the introduction @jenweber!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants