Update Scaffold docs and example code (#24159)

Upgraded Scaffold example to an application example.

packages/flutter/lib/src/material/scaffold.dart

@@ -657,32 +657,39 @@ class _FloatingActionButtonTransitionState extends State<_FloatingActionButtonTr
 /// [ScaffoldState] for the current [BuildContext] via [Scaffold.of] and use the
 /// [ScaffoldState.showSnackBar] and [ScaffoldState.showBottomSheet] functions.
 ///
-/// {@tool sample}
+/// {@tool snippet --template=stateful_widget}
 ///
-/// This example shows a [Scaffold] with an [AppBar], a [BottomAppBar]
-/// and a [FloatingActionButton]. The [body] is a [Text] placed in a [Center]
-/// in order to center the text within the [Scaffold] and the
-/// [FloatingActionButton] is centered and docked within the
-/// [BottomAppBar] using [FloatingActionButtonLocation.centerDocked].
+/// This example shows a [Scaffold] with an [AppBar], a [BottomAppBar] and a
+/// [FloatingActionButton]. The [body] is a [Text] placed in a [Center] in order
+/// to center the text within the [Scaffold] and the [FloatingActionButton] is
+/// centered and docked within the [BottomAppBar] using
+/// [FloatingActionButtonLocation.centerDocked]. The [FloatingActionButton] is
+/// connected to a callback that increments a counter.
 ///
 /// ```dart
-/// Scaffold(
+/// int _count = 0;
+///
+/// Widget build(BuildContext context) {
+///   return Scaffold(
 ///     appBar: AppBar(
 ///       title: Text('Sample Code'),
 ///     ),
 ///     body: Center(
-///     child: Text('Scaffold'),
+///       child: Text('You have pressed the button $_count times.'),
 ///     ),
 ///     bottomNavigationBar: BottomAppBar(
 ///       child: Container(height: 50.0,),
 ///     ),
 ///     floatingActionButton: FloatingActionButton(
-///     onPressed: () {},
-///     tooltip: 'Increment',
+///       onPressed: () => setState(() {
+///         _count++;
+///       }),
+///       tooltip: 'Increment Counter',
 ///       child: Icon(Icons.add),
 ///     ),
 ///     floatingActionButtonLocation: FloatingActionButtonLocation.centerDocked,
-/// )
+///   );
+/// }
 /// ```
 /// {@end-tool}
 ///