diff --git a/.agents/skills/stage-site/SKILL.md b/.agents/skills/stage-site/SKILL.md new file mode 100644 index 0000000000..6e61bad0df --- /dev/null +++ b/.agents/skills/stage-site/SKILL.md @@ -0,0 +1,54 @@ +--- +name: stage-site +description: >- + Stages the Flutter site locally. This includes checking for broken links, + verifying excerpts, updating formatting, and serving the dev site. +--- + +# Stage the Flutter site + +Before committing changes or reviewing a PR locally, +it is important to stage the site and ensure everything works correctly. +Follow these steps to stage the site: + +## 1. Check for broken links + +Run the following command to check for any unlinked or broken +Markdown link references in the site output: + +```bash +dart run dash_site check-link-references +``` + +Alternatively, to verify all links between pages on the site work: + +```bash +dart run dash_site check-links +``` + +If any broken links are found, try to patch them or alert the user. + +## 2. Sync code excerpts + +Ensure that any changed code excerpts are properly run and synced to the Markdown files: + +```bash +dart run dash_site refresh-excerpts +``` + +## 3. Update formatting + +Update the formatting of the site examples and tools to ensure +they follow the official Dart format: + +```bash +dart run dash_site format-dart +``` + +## 4. Stage the site locally + +Finally, serve a local development server of the site so the user can preview the changes: + +```bash +dart run dash_site serve +``` diff --git a/src/content/install/manual.md b/src/content/install/manual.md index a8fd13a818..4b3b24ed70 100644 --- a/src/content/install/manual.md +++ b/src/content/install/manual.md @@ -191,6 +191,13 @@ then extract the SDK to where you want it stored. -Destination $env:USERPROFILE\develop\ ``` + :::note + If the `flutter.bat` file is missing from the `bin` directory + after extraction, your antivirus software might have quarantined it. + If this happens, configure your antivirus to trust the Flutter SDK directory, + then extract the bundle again. + ::: + {: .steps .windows-only} 1.

Download the Flutter SDK bundle

@@ -319,7 +326,9 @@ the Flutter team recommends you first try out