Skip to content

[material_ui] [cupertino_ui] Add missing Widget of the Week videos to widget API docs - #12468

Open
piedcipher wants to merge 19 commits into
mainfrom
fix/191031
Open

[material_ui] [cupertino_ui] Add missing Widget of the Week videos to widget API docs#12468
piedcipher wants to merge 19 commits into
mainfrom
fix/191031

Conversation

@piedcipher

@piedcipher piedcipher commented Aug 13, 2026

Copy link
Copy Markdown
Member

Add missing Widget of the Week videos to widget API docs.

Screenshot 2026-08-14 at 12 50 04 AM

Audited all 181 videos and added missing ones in the docs.

Fixes github.com/flutter/flutter/issues/191031

Also check flutter/flutter#191070

Pre-Review Checklist

If you need help, consider asking for advice on the #hackers-new channel on Discord.

Note: The Flutter team is currently trialing the use of Gemini Code Assist for GitHub. Comments from the gemini-code-assist bot should not be taken as authoritative feedback from the Flutter team. If you find its comments useful you can update your code accordingly, but if you are unsure or disagree with the feedback, please feel free to wait for a Flutter team member's review for guidance on which automated comments should be addressed.

Footnotes

  1. Regular contributors who have demonstrated familiarity with the repository guidelines only need to comment if the PR is not auto-exempted by repo tooling. 2

@piedcipher piedcipher self-assigned this Aug 13, 2026
@piedcipher piedcipher changed the title Add missing Widget of the Week videos to widget API docs [material_ui] [cupertino_ui] Add missing Widget of the Week videos to widget API docs Aug 13, 2026
@piedcipher
piedcipher requested review from Piinks and jmagman August 13, 2026 20:39
@github-actions github-actions Bot added triage-framework Should be looked at in framework triage p: cupertino_ui p: material_ui labels Aug 13, 2026
@piedcipher
piedcipher marked this pull request as ready for review August 13, 2026 20:45

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the documentation for several widgets in the cupertino_ui and material_ui packages by adding missing "Widget of the Week" YouTube video links. It also bumps the package versions to 1.0.1 and updates their respective changelogs. I have no feedback to provide.

@Piinks Piinks left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey @piedcipher thanks for porting these over so quick!
I forgot, @youtube does not work outside of flutter/flutter, but is should soon: dart-lang/pub-dev#9490 (comment)

We worked around this for now in these packages by just embedding the link to the widget videos in the text, e.g.:

/// Learn more about [CupertinoActivityIndicator] on the [Flutter YouTube channel](https://www.youtube.com/watch?v=AENVH-ZqKDQ).

On another note, these packages are using a new batch release process to prevent the bottleneck of constant merge conflicts with the pubspec and changelog. Instead, you can create a pending changelog, and then we compile them together when the release goes out. There are instructions on adding the pending changelog file in flutter/flutter#188444 under "The flutter/packages changelog file". You can use the tool to create one, or you can create the file yourself using the template under pending_changelogs/

@piedcipher
piedcipher marked this pull request as draft August 13, 2026 21:02
@piedcipher

Copy link
Copy Markdown
Member Author

Thanks! I’ve done all of that. Appreciate the help!

@piedcipher
piedcipher marked this pull request as ready for review August 13, 2026 21:34

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request adds links to Widget of the Week YouTube videos within the API documentation for CupertinoSliverNavigationBar, Badge, CarouselView, SearchAnchor, SearchBar, and SegmentedButton. It also adds corresponding changelog files for the cupertino_ui and material_ui packages. There are no review comments, and I have no feedback to provide.

@jmagman jmagman left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Confirmed all the links are pointed to the correct videos!

@jmagman jmagman added the CICD Run CI/CD label Aug 14, 2026
okorohelijah pushed a commit to okorohelijah/flutter that referenced this pull request Aug 17, 2026
)

Add missing Widget of the Week videos to widget API docs.

<img width="1512" height="982" alt="Screenshot 2026-08-14 at 12 50
04 AM"
src="https://github.com/user-attachments/assets/b3a2072e-4b4d-4ad7-baa7-50baf9aeed15"
/>

Audited all
[181](https://www.youtube.com/playlist?list=PLjxrf2q8roU23XGwz3Km7sQZFTdB996iG)
videos and added missing ones in the docs.

<!--
Thanks for filing a pull request!
Reviewers are typically assigned within a week of filing a request.
To learn more about code review, see our documentation on Tree Hygiene:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md
-->

Fixes flutter#191031

Also check flutter/packages#12468

## Pre-launch Checklist

- [x] I read the [Contributor Guide] and followed the process outlined
there for submitting PRs.
- [x] I read the [AI contribution guidelines] and understand my
responsibilities, or I am not using AI tools.
- [x] I read the [Tree Hygiene] wiki page, which explains my
responsibilities.
- [x] I read and followed the [Flutter Style Guide], including [Features
we expect every widget to implement].
- [x] I signed the [CLA].
- [x] I listed at least one issue that this PR fixes in the description
above.
- [x] I updated/added relevant documentation (doc comments with `///`).
- [ ] I added new tests to check the change I am making, or this PR is
[test-exempt].
- [x] I followed the [breaking change policy] and added [Data Driven
Fixes] where supported.
- [x] All existing and new tests are passing.

If you need help, consider asking for advice on the #hackers-new channel
on [Discord].

If this change needs to override an active code freeze, provide a
comment explaining why. The code freeze workflow can be overridden by
code reviewers. See pinned issues for any active code freezes with
guidance.

**Note**: The Flutter team is currently trialing the use of [Gemini Code
Assist for
GitHub](https://developers.google.com/gemini-code-assist/docs/review-github-code).
Comments from the `gemini-code-assist` bot should not be taken as
authoritative feedback from the Flutter team. If you find its comments
useful you can update your code accordingly, but if you are unsure or
disagree with the feedback, please feel free to wait for a Flutter team
member's review for guidance on which automated comments should be
addressed.

<!-- Links -->
[Contributor Guide]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#overview
[AI contribution guidelines]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#ai-contribution-guidelines
[Tree Hygiene]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md
[test-exempt]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#tests
[Flutter Style Guide]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md
[Features we expect every widget to implement]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#features-we-expect-every-widget-to-implement
[CLA]: https://cla.developers.google.com/
[flutter/tests]: https://github.com/flutter/tests
[breaking change policy]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#handling-breaking-changes
[Discord]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Chat.md
[Data Driven Fixes]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Data-driven-Fixes.md
@Piinks Piinks added triage-design Should be looked at in design triage and removed triage-framework Should be looked at in framework triage labels Aug 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CICD Run CI/CD p: cupertino_ui p: material_ui triage-design Should be looked at in design triage

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants