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.

Sign up for GitHub

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

Jump to bottom

Expand on the documentation for callable classes #4267

Open
parlough opened this issue Oct 6, 2022 · 1 comment
Open

Expand on the documentation for callable classes #4267

parlough opened this issue Oct 6, 2022 · 1 comment
Labels
a.language Relates to the Dart language tour e2-days Can complete in < 5 days of normal, not dedicated, work p2-medium Necessary but not urgent concern. Resolve when possible. st.triage.ltw Indicates Lead Tech Writer has triaged

Comments

@parlough
Copy link
Member

parlough commented Oct 6, 2022 •
edited by atsansone
Loading

Page URL

https://dart.dev/language/callable-classes

Page source

https://github.com/dart-lang/site-www/tree/main/src/language/callable-classes.md

Describe the problem

We used to have an article called Emulating functions in Dart, but now have very limited documentation.

Expected fix

We should analyze relevant portions and incorporate what's still relevant, including use cases for the construct.

Perhaps three goals are:

  1. Make the implicit tear-off behavior clear, that is discussed more here (Language tour should clarify relationship between callable classes and functions #2071).
  2. Document what use cases this is useful/important in, rather than just what it does.
  3. Perhaps more explicitly link to the Functions section with an indication that the same functionality is supported.

Additional context

Related issues:

Also consider the possibility of removal of implicit tear-offs of call: dart-lang/linter#3592
@parlough parlough added a.language Relates to the Dart language tour p3-low Valid but not urgent concern. Resolve when possible. Encourage upvote to surface. docs e1-hours Can complete in < 8 hours of normal, not dedicated, work labels Oct 6, 2022
@parlough parlough mentioned this issue Oct 6, 2022
Closed
@parlough parlough changed the title Expand on the documentation for callabe classes Expand on the documentation for callable classes Oct 6, 2022
@MahmoudShawkyy
Copy link
Contributor

Hello @parlough I am working on this Part in Docs, and I will submit a PR after finishing it.

@parlough parlough mentioned this issue Oct 20, 2022
Merged
@atsansone atsansone removed the docs label Apr 5, 2023
@atsansone atsansone mentioned this issue Apr 5, 2023
Closed
@atsansone atsansone added the st.triage.ltw Indicates Lead Tech Writer has triaged label May 1, 2023
@atsansone atsansone removed a.language Relates to the Dart language tour p3-low Valid but not urgent concern. Resolve when possible. Encourage upvote to surface. e1-hours Can complete in < 8 hours of normal, not dedicated, work st.triage.ltw Indicates Lead Tech Writer has triaged labels Sep 18, 2023
@danagbemava-nc danagbemava-nc added st.triage.triage-team Triage team reviewing and categorizing the issue a.language Relates to the Dart language tour p2-medium Necessary but not urgent concern. Resolve when possible. e2-days Can complete in < 5 days of normal, not dedicated, work and removed st.triage.triage-team Triage team reviewing and categorizing the issue labels Sep 22, 2023
@atsansone atsansone added the st.triage.ltw Indicates Lead Tech Writer has triaged label Oct 17, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
a.language Relates to the Dart language tour e2-days Can complete in < 5 days of normal, not dedicated, work p2-medium Necessary but not urgent concern. Resolve when possible. st.triage.ltw Indicates Lead Tech Writer has triaged
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
4 participants
@atsansone @parlough @MahmoudShawkyy @danagbemava-nc