Skip to content

Confusing comment for ComponentElement #4505

Closed

Description

@jimbeveridge

In framework.dart, the class level comment for ComponentElement says:

/// Base class for the instantiation of [StatelessWidget], [StatefulWidget],
/// and [_ProxyWidget] widgets.

The exact meaning of this is difficult to grok. ComponentElement is not a base class for any of those other classes, so that's not it. Based on the related comment above Element that Elements are the instantiations of Widget configurations, I think you have a particular meaning in mind for the word instantiation, but it's hard to infer from context.

Activity

  1. self-assigned this
    on Jun 12, 2016
  2. abarth commented on Jun 12, 2016

    @abarth
    Contributor

    Yeah, I've got a branch where I'm working on the documentation for framework.dart. There are lots of parts that need improvement, including this one.

  3. modified the milestone: on Aug 1, 2016
  4. added a commit that references this issue on Sep 15, 2016
    9109bb0
  5. added a commit that references this issue on May 14, 2018
  6. github-actions commented on Aug 15, 2021

    @github-actions

    This thread has been automatically locked since there has not been any recent activity after it was closed. If you are still experiencing a similar issue, please open a new bug, including the output of flutter doctor -v and a minimal reproduction of the issue.

  7. locked as resolved and limited conversation to collaborators on Aug 15, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions