Incorporate Google I/O 2023 and Flutter 3.10 docs

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,5 +1,9 @@
-**IMPORTANT:** Due to work on the docs.flutter.dev infrastructure, this repo is **not accepting pull requests**.
+_Description of what this PR is changing or adding, and why:_
 
-Instead of creating a PR, please file an issue (https://github.com/flutter/website/issues/new/choose) about the needed change.
+_Issues fixed by this PR (if any):_
 
-We expect to start accepting PRs again the week of May 10th.
+## Presubmit checklist
+
+- [ ] This PR doesn’t contain automatically generated corrections (Grammarly or similar).
+- [ ] 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).
+- [ ] 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.

.github/workflows/codeql-analysis.yml

@@ -33,7 +33,7 @@ jobs:
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL
-      uses: github/codeql-action/init@b2c19fb9a2a485599ccf4ed5d65527d94bc57226
+      uses: github/codeql-action/init@29b1f65c5e92e24fe6b6647da1eaabe529cec70f
       with:
         languages: ${{ matrix.language }}
         # If you wish to specify custom queries, you can do so here or in a config file.
@@ -44,7 +44,7 @@ jobs:
     # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
     # If this step fails, then you should remove it and run the build manually (see below)
     - name: Autobuild
-      uses: github/codeql-action/autobuild@b2c19fb9a2a485599ccf4ed5d65527d94bc57226
+      uses: github/codeql-action/autobuild@29b1f65c5e92e24fe6b6647da1eaabe529cec70f
 
     # ℹ️ Command-line programs to run using the OS shell.
     # 📚 https://git.io/JvXDl
@@ -58,4 +58,4 @@ jobs:
     #   make release
 
     - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@b2c19fb9a2a485599ccf4ed5d65527d94bc57226
+      uses: github/codeql-action/analyze@29b1f65c5e92e24fe6b6647da1eaabe529cec70f

.github/workflows/scorecards-analysis.yml

@@ -50,6 +50,6 @@ jobs:
 
       # Upload the results to GitHub's code scanning dashboard.
       - name: "Upload to code-scanning"
-        uses: github/codeql-action/upload-sarif@b2c19fb9a2a485599ccf4ed5d65527d94bc57226
+        uses: github/codeql-action/upload-sarif@29b1f65c5e92e24fe6b6647da1eaabe529cec70f
         with:
           sarif_file: results.sarif

.github/workflows/stage.yml

@@ -11,18 +11,20 @@ permissions: read-all
 jobs:
   stage:
     permissions:
+      contents: read
       checks: write
       pull-requests: write
     runs-on: ubuntu-latest
     if: ${{ github.ref != 'refs/heads/main' }}
     steps:
-      - uses: actions/checkout@8f4b7f84864484a7bf31766abe9204da3cbe65b3
+      - uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab
         with:
           submodules: recursive
       - name: Build site and check links
         run: make build BUILD_CONFIGS=_config.yml,_config_stage.yml
       - name: Stage site on Firebase
         if: ${{
+          github.repository == 'flutter/website' &&
           github.event.pull_request.head.repo.full_name == github.repository &&
           github.event.pull_request.user.login != 'dependabot[bot]' }}
         uses: FirebaseExtended/action-hosting-deploy@4d0d0023f1d92b9b7d16dda64b3d7abd2c98974b

Dockerfile

@@ -1,4 +1,4 @@
-FROM ruby:3.2-2-slim-bullseye@sha256:d8e5caa21b5ebc425828af1eb43a678afceaca80681cac26b457063a18488e10 AS base
+FROM ruby:3.2.2-slim-bullseye@sha256:70370316b02901d7db3f6e453d6259ed4d0d52326d6ac57e3a579f7e3b616e41 AS base
 
 ENV TZ=US/Pacific
 RUN apt-get update && apt-get install -yq --no-install-recommends \

examples/_animation/basic_hero_animation/pubspec.yaml

@@ -2,7 +2,7 @@ name: basic_hero_transition
 description: Shows how to create a simple or Hero animation using the Hero class directly.
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/_animation/basic_radial_hero_animation/pubspec.yaml

@@ -2,7 +2,7 @@ name: basic_radial_hero_transition
 description: Shows how to apply a radial transformation to the Hero as it animates to the new route.
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/_animation/basic_staggered_animation/pubspec.yaml

@@ -2,7 +2,7 @@ name: basic_staggered
 description: A new Flutter project.
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/_animation/hero_animation/pubspec.yaml

@@ -2,7 +2,7 @@ name: hero_animation
 description: Shows how to create a simple Hero transition.
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/_animation/radial_hero_animation/pubspec.yaml

@@ -2,7 +2,7 @@ name: radial_hero_animation
 description: Shows how to apply a radial transformation to the Hero as it animates to the new route.
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/_animation/radial_hero_animation_animate_rectclip/pubspec.yaml

@@ -2,7 +2,7 @@ name: radial_hero_animation_animate_rectclip
 description: Shows how to apply a radial transformation to the Hero as it animates to the new route.
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/_animation/staggered_pic_selection/pubspec.yaml

@@ -2,7 +2,7 @@ name: staggered_pic_selection
 description: A new Flutter project.
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/animation/animate0/pubspec.yaml

@@ -4,7 +4,7 @@ description: >
 version: 1.0.0
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/animation/animate1/pubspec.yaml

@@ -4,7 +4,7 @@ description: >
 version: 1.0.0
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/animation/animate2/pubspec.yaml

@@ -4,7 +4,7 @@ description: >
 version: 1.0.0
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/animation/animate3/pubspec.yaml

@@ -4,7 +4,7 @@ description: >
 version: 1.0.0
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/animation/animate4/pubspec.yaml

@@ -4,7 +4,7 @@ description: >
 version: 1.0.0
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/animation/animate5/pubspec.yaml

@@ -4,7 +4,7 @@ description: >
 version: 1.0.0
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/animation/explicit/pubspec.yaml

@@ -5,7 +5,7 @@ publish_to: 'none'
 version: 1.0.0+1
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/animation/implicit/opacity0/lib/main.dart

@@ -20,8 +20,8 @@ class FadeInDemo extends StatelessWidget {
             style: TextStyle(color: Colors.blueAccent),
           ),
           onPressed: () => {}),
-      Column(
-        children: const [
+      const Column(
+        children: [
           Text('Type: Owl'),
           Text('Age: 39'),
           Text('Employment: None'),

examples/animation/implicit/opacity1/lib/main.dart

@@ -25,8 +25,8 @@ class _FadeInDemoState extends State<FadeInDemo> {
             style: TextStyle(color: Colors.blueAccent),
           ),
           onPressed: () => {}),
-      Column(
-        children: const [
+      const Column(
+        children: [
           Text('Type: Owl'),
           Text('Age: 39'),
           Text('Employment: None'),

examples/animation/implicit/opacity10/lib/main.dart

@@ -33,8 +33,8 @@ class _FadeInDemoState extends State<FadeInDemo> {
       AnimatedOpacity(
         duration: const Duration(seconds: 3),
         opacity: opacityLevel,
-        child: Column(
-          children: const [
+        child: const Column(
+          children: [
             Text('Type: Owl'),
             Text('Age: 39'),
             Text('Employment: None'),

examples/animation/implicit/opacity2/lib/main.dart

@@ -28,8 +28,8 @@ class _FadeInDemoState extends State<FadeInDemo> {
           ),
           onPressed: () => {}),
       AnimatedOpacity(
-        child: Column(
-          children: const [
+        child: const Column(
+          children: [
             Text('Type: Owl'),
             Text('Age: 39'),
             Text('Employment: None'),

examples/animation/implicit/opacity3/lib/main.dart

@@ -30,8 +30,8 @@ class _FadeInDemoState extends State<FadeInDemo> {
       AnimatedOpacity(
         duration: const Duration(seconds: 3),
         opacity: opacity,
-        child: Column(
-          children: const [
+        child: const Column(
+          children: [
             Text('Type: Owl'),
             Text('Age: 39'),
             Text('Employment: None'),

examples/animation/implicit/opacity4/lib/main.dart

@@ -30,8 +30,8 @@ class _FadeInDemoState extends State<FadeInDemo> {
       AnimatedOpacity(
         duration: const Duration(seconds: 2),
         opacity: opacity,
-        child: Column(
-          children: const [
+        child: const Column(
+          children: [
             Text('Type: Owl'),
             Text('Age: 39'),
             Text('Employment: None'),

examples/animation/implicit/opacity5/lib/main.dart

@@ -33,8 +33,8 @@ class _FadeInDemoState extends State<FadeInDemo> {
       AnimatedOpacity(
         duration: const Duration(seconds: 2),
         opacity: opacity,
-        child: Column(
-          children: const [
+        child: const Column(
+          children: [
             Text('Type: Owl'),
             Text('Age: 39'),
             Text('Employment: None'),

examples/animation/implicit/opacity9/lib/main.dart

@@ -20,8 +20,8 @@ class FadeInDemo extends StatelessWidget {
             style: TextStyle(color: Colors.blueAccent),
           ),
           onPressed: () => {}),
-      Column(
-        children: const [
+      const Column(
+        children: [
           Text('Type: Owl'),
           Text('Age: 39'),
           Text('Employment: None'),

examples/animation/implicit/pubspec.yaml

@@ -5,7 +5,7 @@ publish_to: 'none'
 version: 1.0.0+1
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/basics/pubspec.yaml

@@ -3,7 +3,7 @@ description: Some code to demonstrate null safety.
 version: 1.0.0
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/cookbook/animation/animated_container/pubspec.yaml

@@ -2,7 +2,7 @@ name: animated_container
 description: Sample code for cookbook.
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/cookbook/animation/opacity_animation/pubspec.yaml

@@ -2,7 +2,7 @@ name: opacity_animation
 description: Sample code for cookbook.
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/cookbook/animation/page_route_animation/pubspec.yaml

@@ -2,7 +2,7 @@ name: page_route_animation
 description: Sample code for cookbook.
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/cookbook/animation/physics_simulation/pubspec.yaml

@@ -2,7 +2,7 @@ name: physics_simulation
 description: Sample code for cookbook.
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/cookbook/design/drawer/pubspec.yaml

@@ -2,7 +2,7 @@ name: drawer
 description: Sample code for drawer cookbook recipe.
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/cookbook/design/fonts/pubspec.yaml

@@ -4,7 +4,7 @@ publish_to: 'none'
 version: 1.0.0+1
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/cookbook/design/orientation/pubspec.yaml

@@ -2,7 +2,7 @@ name: orientation
 description: Sample code for orientation cookbook recipe.
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/cookbook/design/package_fonts/pubspec.yaml

@@ -4,7 +4,7 @@ publish_to: 'none'
 version: 1.0.0+1
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/cookbook/design/snackbars/pubspec.yaml

@@ -2,7 +2,7 @@ name: snackbars
 description: Sample code for snackbars cookbook recipe.
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter:

examples/cookbook/design/tabs/pubspec.yaml

@@ -2,7 +2,7 @@ name: tabs
 description: Sample code for tabs cookbook recipe.
 
 environment:
-  sdk: '>=2.18.5 <3.0.0'
+  sdk: ^3.0.0-0
 
 dependencies:
   flutter: