Added part of the desktop revisions

src/_includes/docs/install/admonitions/install-paths.md

@@ -0,0 +1,12 @@
+
+   {{site.alert.warning}}
+
+      Don't install Flutter to a directory or path that meets
+      one or both of the following conditions:
+
+      * The path contains special characters or spaces.
+      * The path requires elevated privileges.
+
+      As an example, `C:\Program Files\` fails both conditions.
+
+   {{site.alert.end}}

src/_includes/docs/install/flutter/download.md

@@ -12,32 +12,26 @@
 {% endif -%}
 
 1. Download the following installation bundle to get the latest
-   {{site.sdk.channel}} release of the Flutter SDK:
+   {{site.sdk.channel}} release of the Flutter SDK.
 
    [(loading...)](#){:.download-latest-link-{{osl}}.btn.btn-primary}
 
    For other release channels, and older builds,
    check out the [SDK archive][].
 
-1. Extract the zip file.
+1. Create a folder where you can install Flutter.
 
-   ```terminal
-   {{unzip}} [(loading...)](#){:.download-latest-link-{{osl}}}
-   ```
+   Consider `%USERPROFILE%` or `D:\dev`.
 
-1. Move the contained `flutter` directory
-   to where you want to store the Flutter SDK.
+   {% include docs/install/admonitions/install-paths.md %}
 
-   {{site.alert.warning}}
-   Do not install Flutter to a directory or path that meets
-   one or both of the following conditions:
+1. Move the zip file into the directory you want to store the Flutter SDK.
 
-   - The path contains special characters or spaces.
-   - The path requires elevated privileges.
+1. Extract the zip file.
 
-   As an example, `C:\Program Files\` fails both conditions.
-   You could use `%USERPROFILE%\flutter` or `D:\dev\flutter`.
-   {{site.alert.end}}
+   ```terminal
+   {{unzip}} {:.download-latest-link-{{osl}}}
+   ```
 
 [SDK archive]: {{site.url}}/release/archive
 

src/_includes/docs/install/flutter/vscode.md

@@ -4,6 +4,8 @@
 #### Start Flutter install
 {:.no_toc}
 
+1. Open VS Code.
+
 1. To open the Command Palette,
    press <kbd>Control</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd>.
 
@@ -13,13 +15,18 @@
 
 1. VS Code prompts you to locate the Flutter SDK on your computer.
 
+   {:type="a"}
    1. If you have the Flutter SDK installed, click **Locate SDK**.
 
    1. If you do not have the Flutter SDK installed, click **Download SDK**.
 
       This option sends you the Flutter install page if you have not installed
       Git for Windows as directed in the [development tools prerequisites][].
 
+1. When prompted **Which Flutter template?**, ignore it.
+   Press <kbd>Esc</kbd>.
+   You can create a test project after checking your development setup.
+
 #### Download the Flutter SDK
 {:.no_toc}
 
@@ -29,6 +36,10 @@
    VS Code places you in your user profile to start.
    Choose a different location.
 
+   Consider `%USERPROFILE%` or `D:\dev`.
+
+   {% include docs/install/admonitions/install-paths.md %}
+
 1. Click **Clone Flutter**.
 
    While downloading Flutter, a notification displays:
@@ -37,6 +48,10 @@
    Downloading the Flutter SDK. This may take a few minutes.
    ```
 
+   This download takes a few minutes.
+   If you suspect that the download has hung, click **Cancel** then
+   start the installation again.
+
 1. Once it finishes downloading Flutter, the **Output** panel displays.
 
    ```terminal
@@ -67,7 +82,9 @@
    Downloading windows-x64/font-subset tools...
    ```
 
-   This process also runs `flutter doctor -v`. _Ignore this output._
+   This process also runs `flutter doctor -v`.
+   At this point in the procedure, _ignore this output._
+   Flutter Doctor might show errors that don't apply to this quick start.
 
    When the Flutter install succeeds, a notification displays: