*Breaking change* Deprecate CurvedAnimation.reverseCurve in favor of AsymmetricCurvedAnimation

[adil192]

Description of what this PR is changing or adding, and why:

Adds a migration guide for a breaking change in flutter/flutter#185797.

PRs or commits this PR depends on (if any):

• Deprecate CurvedAnimation.reverseCurve for AsymmetricCurvedAnimation flutter#185797

Presubmit checklist

• If you are unwilling, or unable, to sign the CLA, even for a tiny, one-word PR, please file an issue instead of a PR.
• If this PR is not meant to land until a future stable release, mark it as draft with an explanation.
• This PR follows the Google Developer Documentation Style Guidelines—for example, it doesn't use i.e. or e.g., and it avoids I and we (first-person pronouns).
• This PR uses semantic line breaks
  of 80 characters or fewer.

[sfshaza2]

/gcbrun

[flutter-website-bot]

Visit the preview URL for this PR (updated for commit 2321bc7):

https://flutter-docs-prod--pr13347-breaking-changes-deprecate-ftgcwv6g.web.app

[sfshaza2]

@adil192, can we land this? If so, please remove from draft model.

[adil192]

@sfshaza2 Don't we need to wait until flutter/flutter#185797 lands?

@loic-sharma Do we have a deprecation window to put in the Timeline section?

[gemini-code-assist]

Code Review

This pull request adds documentation for the deprecation of CurvedAnimation.reverseCurve in favor of AsymmetricCurvedAnimation and registers this new breaking change in the index. The review feedback focuses on correcting several API documentation link references where links meant for CurvedAnimation (such as reverseCurve and dispose) incorrectly point to AsymmetricCurvedAnimation. It also addresses a line length limit violation and suggests adding the missing reference link definitions.

[flutter-website-bot]

Staged preview of the updated docs.flutter.dev site (updated for commit ce8adfe):

https://flutter-docs-prod--docs-pr13347-breaking-changes-depre-s7gn3urm.web.app

[gemini-code-assist]

Code Review

This pull request adds a new breaking change document detailing the deprecation of CurvedAnimation.reverseCurve in favor of AsymmetricCurvedAnimation, and updates the index page to link to it. The review feedback suggests wrapping a line in the markdown file that exceeds the 80-character limit, and correcting the alphabetical sorting of the new entry and its link definition in the index file.

[adil192]

Rebased and ready for review/merge along with flutter/flutter#185797

Edit: Marked as draft, see the link for details.