CUJ index [land silently] - #13769
Conversation
Extract generic two-column filterable index layout styles and sidebar/search components from learning resources into reusable filterable_index.dart and _filterable-index.scss.
Adds the canonical Critical User Journeys (CUJs) data, data model, filterable index page components, and styling for /ai/flutter-bench/cujs.
|
Staged preview of the updated docs.flutter.dev site (updated for commit 260df07): https://flutter-docs-prod--docs-pr13769-cuj-index-ucwmiabz.web.app |
|
Staged preview of the updated flutter.dev site (updated for commit 260df07): https://flutter-dev-230821--www-pr13769-cuj-index-eerbuymc.web.app |
# Conflicts: # sites/docs/lib/_sass/components/_filterable-index.scss # sites/docs/lib/src/components/pages/filterable_index.dart # sites/docs/lib/src/components/pages/learning_resource_filters_sidebar.dart
There was a problem hiding this comment.
Code Review
This pull request introduces a new Critical User Journey (CUJ) index page, including a catalog of journeys, search and filter capabilities, and responsive styling. The feedback highlights several critical syntax errors where .text(...) is used instead of Text(...), which will cause compilation failures. Additionally, the reviewer pointed out potential runtime crashes related to unsafe type casting of page data and checkbox states, a potential exception from calling setState on an unmounted widget, and recommended using a more specific CSS selector for querying card elements.
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
lamek
left a comment
There was a problem hiding this comment.
LGTM on the docs stuff. I added some fixes and suggestions. I'll leave the code review to Parker and Killian.
Page I reviewed: https://flutter-docs-prod--docs-pr13769-cuj-index-ucwmiabz.web.app/ai/flutter-bench/cujs
sfshaza2
left a comment
There was a problem hiding this comment.
I'm a bit confused here. I looked at the staged site and I can't find the /ai/flutter-bench page that is referred to in the PR. I know that @jesskuras's restructuring PR does have that page, so is this PR waiting for her PR to land? If so, maybe mark this as draft...
The path will change depending on Jess's change's, so I'm just waiting for that PR to land to know what to update it to. |
parlough
left a comment
There was a problem hiding this comment.
Cool! Generally looking good to me. Some small suggestions:
Co-authored-by: Parker Lougheed <parlough@gmail.com>
parlough
left a comment
There was a problem hiding this comment.
Thanks for those adjustments @ericwindmill!
I have some final suggestions for you to consider, but none are blocking if you need to land this or prefer to address them as part of follow up work.
| /// The developer personas a critical user journey can belong to. | ||
| /// | ||
| /// [dataValue] must match the `persona` values used in `src/data/cujs.yaml`. | ||
| enum CujPersona { |
There was a problem hiding this comment.
I'd recommend creating a section on this page or some sort of UI to describe these personas further. What they are, how they differ, perhaps an example cuj.
Description of what this PR is changing or adding, and why:
This PR adds a CUJ index page, which is landed silently for now. This is an effort to break up the currently massive #13691