Adds wide gamut framework breakage notice.

[gaaclarke]

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

Adding breaking change notice for wide gamut colors in the framework.

Issues fixed by this PR (if any):

flutter/flutter#127855

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

flutter/engine#54737

Presubmit checklist

• This PR is marked as draft with an explanation if not meant to land until a future stable release.
• This PR doesn’t contain automatically generated corrections (Grammarly or similar).
• 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).
• This PR uses semantic line breaks of 80 characters or fewer.

[matanlurey]

A few suggestions. Thanks for writing this up!

[sfshaza2]

Thanks, @gaaclarke, for such a thorough review. Let's iterate. :D

[sfshaza2]

/gcbrun

[sfshaza2]

/gcbrun

[gaaclarke]

Note: added a section specifically for "opacity" in response to feedback from flutter/flutter#154491

[sfshaza2]

@parlough, two questions:

1. Staging is failing with "File cloud_build/stage.yaml not found". What is that about?
2. I wanted to include the link of the generated page, showing that ":::note" is accurate, but I can't find the staged page. I guess because the cloud_build file is missing?

[sfshaza2]

/gcbrun

[flutter-website-bot]

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

https://flutter-docs-prod--pr11082-wide-gamut-framework-2mwyak42.web.app

[sfshaza2]

lgtm

[gaaclarke]

Hey @sfshaza2, should https://flutter-docs-prod--pr11082-wide-gamut-framework-2mwyak42.web.app/release/breaking-changes show this as being added? I'm not sure where to preview the page or what to edit to make it show up there.

[sfshaza2]

Yes, indeed! I meant to list that, but forgot.

…

On Thu, Sep 5, 2024 at 1:27 PM gaaclarke ***@***.***> wrote: Hey @sfshaza2 <https://github.com/sfshaza2>, should https://flutter-docs-prod--pr11082-wide-gamut-framework-2mwyak42.web.app/release/breaking-changes show this as being added? I'm not sure where to preview the page or what to edit to make it show up there. — Reply to this email directly, view it on GitHub <#11082 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AKS4PKLMSBUEVZ6DS3PNJR3ZVC5DRAVCNFSM6AAAAABNEZ67SOVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDGMZSGU3TGMZTGE> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[gaaclarke]

Yes, indeed! I meant to list that, but forgot.

Okay, I see where to edit that, but the link https://flutter-docs-prod--pr11082-wide-gamut-framework-2mwyak42.web.app/release/breaking-changes/wide-gamut-framework doesn't work. Is that the correct link for the preview of this page?

[sfshaza2]

/gcbrun

[gaaclarke]

@sfshaza2 I added the entry to the index.md if you want to double check that.

[sfshaza2]

The entry in the breaking change index page is good to go.
However, you've added the new breaking change page under "/src/release/..." This is no longer correct and why I couldn't find the file in the staged site. We now put our content under "/src/content/...".

[gaaclarke]

The entry in the breaking change index page is good to go. However, you've added the new breaking change page under "/src/release/..." This is no longer correct and why I couldn't find the file in the staged site. We now put our content under "/src/content/...".

Moved, thanks.