Skip to content

[Triage/Infra] Consolidate 09_feature.yml umbrella template to free up issue chooser slot #190315

Closed

Description

@kevmoo

Background

GitHub limits the repository issue chooser menu to a maximum of 10 templates (.github/ISSUE_TEMPLATE/*.yml). flutter/flutter is currently at the hard cap of 10 templates:

  1. 01_activation.yml
  2. 02_bug.yml
  3. 03_feature_request.yml
  4. 04_performance_others.yml
  5. 05_performance_speed.yml
  6. 06_infrastructure.yml
  7. 07_design_doc.yml
  8. 08_first_party_packages.yml
  9. 09_feature.yml
  10. 10_google3_bug.yml

Proposal

We propose consolidating 09_feature.yml ("Create an umbrella issue") into 03_feature_request.yml (or consolidating 04_performance_others.yml and 05_performance_speed.yml into a single Performance template).

An audit of flutter/flutter, flutter/website, and historical issue links confirms:

  • 09_feature.yml has 0 code references and 0 external URL references across the organization.
  • Umbrella issues (☂️ <Feature Title>) can easily be documented as a recommended title convention inside 03_feature_request.yml.

Freed capacity in the 10-template chooser menu can then accommodate emerging needs (such as dedicated WebAssembly / framework feedback forms).


Suggested Action

We can submit a clean PR to remove 09_feature.yml and add umbrella title guidance to 03_feature_request.yml.

Activity

  1. added
    c: proposalA detailed proposal for a change to Flutter
    a: triage improvementsMake GitHub issues easier to triage and more actionable
    fyi-infraFor the attention of Infrastructure team
    on Jul 30, 2026
  2. kevmoo commented on Jul 30, 2026

    @kevmoo
    ContributorAuthor
  3. stuartmorgan-g commented on Jul 31, 2026

    @stuartmorgan-g
    Contributor

    If we need to eliminate some templates we should probably gather data about how much use the various templates get (by looking for specific header text, for instance). Taking 08_first_party_packages.yml as an example, we added it because we wanted to avoid round-trips during triage to ask for information we very frequently need for those issues, but in practice only about 12% of package issues filed in the last year actually used that template, because most people just pick "bug" or "feature request" instead, so the utility of having the specialized template is low. Anecdotally, the performance template is frequently used incorrectly, so I'm not sure how much that's buying us either.

    (By the same token though, the utility of adding new specialized templates may well also be low unless we have a specific way to funnel people directly to them.)

  4. kevmoo commented on Jul 31, 2026

    @kevmoo
    ContributorAuthor

    Recommendations

    1. Drop 01_activation.yml (Frees Slot #1)

      • 0 filings in 12 months. Users file install/doctor issues under 02_bug.yml.
    2. Consolidate 09_feature.yml into 03_feature_request.yml (Frees Slot #2)

      • Only 21 filings in 12 months (0.3% of total). Document ☂️ <Title> convention inside 03_feature_request.yml.
    3. Merge 04_performance_others.yml and 05_performance_speed.yml into 1 Performance template (Frees Slot #3)

      • Combined volume is only 17 filings/year (0.26% of total) with >60% misuse/incomplete submissions (missing trace files / default placeholders left untouched). Having two separate performance forms isn't justified.

    Key Data Findings

    1. 08_first_party_packages.yml: Of ~750 package bug reports filed in the last year, 380 (~50.3%) used this template, while ~370 used 02_bug.yml. Usage has grown significantly over previous years.
    2. Performance Templates (04 & 05): Data supports Stuart's observation. Combined filings are extremely low (17 total issues in the last year across both forms). Manual audit shows:
      • ~16% blatant misuse (general UI bugs, routing errors, release mode plugin issues filed under performance).
      • ~44% incomplete (reported jank but left default placeholder text in the timeline trace section without attaching trace data).
      • ~24% valid (contained actual timeline JSON or profile data).
    3. 01_activation.yml: Unused (0 filings in the past year, 14 all-time).
    4. 09_feature.yml: Very low volume (21 filings in the last year).
    Template Usage Data (Past 12 Months)

    Based on form header markers and auto-applied labels across all 6,551 issues created since Aug 1, 2025:

    Template Past 12 Mo. Filings % of Total Issues Usage Notes
    02_bug.yml 4,496 68.6% Default bug template
    06_infrastructure.yml 973 14.9% CI / Devicelab / Infra
    03_feature_request.yml 552 8.4% Feature requests
    08_first_party_packages.yml 380 5.8% Package bugs
    07_design_doc.yml 53 0.8% RFC design docs
    10_google3_bug.yml 50 0.8% Internal Google bugs
    09_feature.yml 21 0.3% Umbrella issues
    05_performance_speed.yml 9 0.1% Speed/jank performance
    04_performance_others.yml 8 0.1% Memory/size performance
    01_activation.yml 0 0.0% Install/doctor issues
  5. kevmoo commented on Jul 31, 2026

    @kevmoo
    ContributorAuthor

    @stuartmorgan-g RE (By the same token though, the utility of adding new specialized templates may well also be low unless we have a specific way to funnel people directly to them.) - I'm going to create a short link to point folks to the template. Going to avoid linking to it directly so it's easy to update later and delete.

  6. goderbauer commented on Jul 31, 2026

    @goderbauer
    Member

    cc @justinmc is maybe the better POC for this than me.

  7. flutter-triage-bot commented on Jul 31, 2026

    @flutter-triage-bot

    The fyi-infra label is redundant with the team-infra label.

  8. jtmcdole commented on Aug 3, 2026

    @jtmcdole
    Member

    This is not team-infra. This is more "team-admin" .

  9. justinmc commented on Aug 3, 2026

    @justinmc
    Contributor

    Is 09_feature even being used? I don't see it when I go to create a new issue: https://github.com/flutter/flutter/issues/new/choose

    If not then I definitely think it can be removed!

  10. kevmoo commented on Aug 3, 2026

    @kevmoo
    ContributorAuthor

    09_feature.yml is the sole template out of all ten files specifying a project attachment: projects: ["flutter/82"].

    project flutter/82 returns HTTP 404 (Not Found)

    When GitHub renders /issues/new/choose, its backend schema validator fails to bind target project flutter/82. Rather than reporting a public UI error, GitHub silently suppresses and drops the failing template from the rendered chooser.

  11. self-assigned this
    on Aug 3, 2026
  12. kevmoo commented on Aug 3, 2026

    @kevmoo
    ContributorAuthor

    I'm going to steal #9 for my use since it's broken anyway and duplicated w/ #03

  13. added a commit that references this issue on Aug 3, 2026
    12b8592
  14. github-actions commented on Aug 17, 2026

    @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.

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

Metadata

Metadata

Assignees

Labels

a: triage improvementsMake GitHub issues easier to triage and more actionablec: proposalA detailed proposal for a change to Flutter

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions