Skip to content

Document constructor tear-offs #3577

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

Closed
kwalrath opened this issue Sep 15, 2021 · 6 comments · Fixed by #5850
Closed

Document constructor tear-offs #3577

kwalrath opened this issue Sep 15, 2021 · 6 comments · Fixed by #5850
Assignees
Labels
a.language Relates to the Dart language tour co.request Community ask for documentation e1-hours Can complete in < 8 hours of normal, not dedicated, work p2-medium Necessary but not urgent concern. Resolve when possible.

Comments

@kwalrath
Copy link
Contributor

kwalrath commented Sep 15, 2021

What information is missing?

Constructor tear-offs are a new feature in 2.15:

How would you like us to fix this problem?

We should probably update the language tour, and also Effective Dart (#3560).

@kwalrath kwalrath added the co.request Community ask for documentation label Sep 15, 2021
@kwalrath kwalrath added this to the Next stable release milestone Sep 15, 2021
@kwalrath kwalrath added e1-hours Can complete in < 8 hours of normal, not dedicated, work p2-medium Necessary but not urgent concern. Resolve when possible. labels Sep 15, 2021
@devoncarew
Copy link
Member

@kwalrath - can you add this to https://github.com/orgs/dart-lang/projects/27? Thanks!

@devoncarew
Copy link
Member

Hmm, I think this and dart-lang/sdk#46243 are dups of each other.

@kwalrath
Copy link
Contributor Author

Hmm, I think this and dart-lang/sdk#46243 are dups of each other.

I think that's OK. This is the place where I'll see it, and that's the place where SDK engineers will see it.

@devoncarew
Copy link
Member

We're mostly tracking this work in a github project - one that sits at the org level. So it can include items from both dart-lang/sdk as well as dart-lang/site-www.

@parlough
Copy link
Member

parlough commented Dec 9, 2021

It seems progress has been made towards this with the Effective Dart work in #3649

As for the language tour, I'm not sure we ever explicitly refer to tear-offs, but do have this related Functions as first-class objects section where we could expand on the idea and add a new example.

@parlough parlough removed this from the Next stable release milestone Dec 9, 2021
@kwalrath
Copy link
Contributor Author

kwalrath commented Dec 9, 2021

The language tour doesn't currently use the word tear-off. I want to update it to use it, and to at least mention the ClassName.new form of constructor tear-off.

@atsansone atsansone added a.language Relates to the Dart language tour ltw-triage labels Apr 17, 2023
@atsansone atsansone self-assigned this May 8, 2024
atsansone added a commit that referenced this issue May 22, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
a.language Relates to the Dart language tour co.request Community ask for documentation e1-hours Can complete in < 8 hours of normal, not dedicated, work p2-medium Necessary but not urgent concern. Resolve when possible.
Projects
None yet
Development

Successfully merging a pull request may close this issue.

4 participants