flutter / flutter/website

Consider providing dedicated prompts or skills for complicated breaking change guides

Open
#13,661 4 comments 0 reactions 0 assignees View on GitHub
act.question act.research e2-days p2-medium
Dominant language
Dart
Stars
3.1k
Forks
3.5k
Avg merge
2d 4h
Merged PRs (30d)
95

Description

It seems the [UIScene](https://docs.flutter.dev/release/breaking-changes/uiscenedelegate) and [Built-in Kotlin](https://docs.flutter.dev/release/breaking-changes/migrate-to-built-in-kotlin) breaking changes/migrations are quite complicated and keep getting more complicated with sometimes multiple additions or clarifications a week. I worry they are getting a bit hard to follow.

Can we/should we suggest developers try using agents to help them with the migrations? If so, is giving them the current guides sufficient, should we provide an optional prompt to get them started? Are the current guides we have now sufficient for agents or we create something more focused or more effective for agents?

I imagine the impact for these two cases is potentially limited now but perhaps it can be an exploration to set a pattern for complicated migrations going forward?

@jmagman @reidbaker @lamek for thoughts.

Contributor guide

Open the contributing guide

Research direction

Start with the UISceneDelegate and Built-in Kotlin breaking-change guides linked in the issue, and review how their current migration steps are organized. Determine whether optional agent prompts or more focused guidance would help; done means establishing a documented, reusable approach for these complicated migrations if the exploration supports one.

Written by the indexing model from the issue text.

Assessment

Tech stack
kotlin
Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.