Skip to content

Commit 5c3e68a

Browse files
authored
Make wording in nested nav recipe device-agnostic. (#11775)
_Description of what this PR is changing or adding, and why:_ The recipe assumed that the developer is building an Android app. * Updated the wording so as not to exclude iOS apps. * Small change to intro to make it clear which pages were being created. _Issues fixed by this PR (if any):_ _PRs or commits this PR depends on (if any):_ ## Presubmit checklist - [x] This PR is marked as draft with an explanation if not meant to land until a future stable release. - [x] This PR doesn’t contain automatically generated corrections (Grammarly or similar). - [x] This PR follows the [Google Developer Documentation Style Guidelines](https://developers.google.com/style) — for example, it doesn’t use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first person). - [x] This PR uses [semantic line breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks) of 80 characters or fewer.
1 parent ae7475f commit 5c3e68a

File tree

2 files changed

+12
-7
lines changed

2 files changed

+12
-7
lines changed

site-shared

src/content/cookbook/effects/nested-nav.md

+11-6
Original file line numberDiff line numberDiff line change
@@ -19,13 +19,18 @@ be better handled nested within another widget.
1919

2020
Consider an Internet of Things (IoT) setup flow for a wireless
2121
light bulb that you control with your app.
22-
This setup flow consists of 4 pages:
23-
find nearby bulbs, select the bulb that you want to add,
24-
add the bulb, and then complete the setup.
22+
This setup flow consists of four pages:
23+
24+
* `find_devices` page: Find nearby bulbs.
25+
* `select_device` page: Select the bulb that you want to
26+
add.
27+
* `connecting` page: Add the bulb.
28+
* `finished` page: Complete the setup.
29+
2530
You could orchestrate this behavior from your top-level
2631
`Navigator` widget. However, it makes more sense to define a second,
2732
nested `Navigator` widget within your `SetupFlow` widget,
28-
and let the nested `Navigator` take ownership over the 4 pages
33+
and let the nested `Navigator` take ownership over the four pages
2934
in the setup flow. This delegation of navigation facilitates
3035
greater local control, which is
3136
generally preferable when developing software.
@@ -160,7 +165,7 @@ want to exit the setup flow.
160165

161166
Prompt the user to confirm exiting the setup flow,
162167
and ensure that the prompt appears when the user
163-
presses the hardware back button on Android.
168+
presses the hardware back button on their device.
164169

165170
<?code-excerpt "lib/prompt_user.dart (PromptUser)"?>
166171
```dart
@@ -232,7 +237,7 @@ PreferredSizeWidget _buildFlowAppBar() {
232237
```
233238

234239
When the user taps the back arrow in the app bar,
235-
or presses the back button on Android,
240+
or presses the back button on their device,
236241
an alert dialog pops up to confirm that the
237242
user wants to leave the setup flow.
238243
If the user presses **Leave**, then the setup flow pops itself

0 commit comments

Comments
 (0)