Update walkthrough based on feedback

- Add additional pictures to clarify certain instructions
- Update the GIFs for testing view and DocC preview
- Ensure that each step has a unique completion action
to ensure that the checkbox is only checked after that step is viewed

Author: rbenegal

assets/walkthrough/createNewProject.md

@@ -14,8 +14,12 @@ Once you select a template, you'll be prompted to enter a name for your new proj
 
 Finally, you'll be prompted to select a location for your new project. You can choose any location in your workspace, or create a new folder.
 
+# Opening Existing Projects
+
 ![Open existing project](./images/openProject.gif)
 
 When you open an existing project with a ``Package.swift`` file the extension will start automatically.
 
-Tip: You can view more information about the toolchain and other configurations being used for the project by hovering over the `{}` icon in the status bar.
+Tip: You can view more information about the toolchain and other configurations being used for the project by hovering over the `{}` icon in the bottom right corner of the status bar.
+
+![Hover over {} to see toolchain info](./images/toolchainInfo.png)

assets/walkthrough/customizeSettings.md

@@ -2,11 +2,7 @@
 
 ![Swift Extension Settings](./images/settings.gif)
 
-The Swift Extension contains several settings you can customize. 
-
-## Workspace Settings
-
-**Add details about custom workspace settings and environment variable here.**
+The Swift Extension contains several settings you can customize. You can filter settings Swift extension settings by searching for `@ext:swiftlang.swift-vscode`.
 
 ## Inlay Hints
 

assets/walkthrough/images/previewDocumentation.gif

@@ -1,6 +1,6 @@
 # Preview Documentation
 ![Preview documentation](./images/previewDocumentation.gif)
 
-You can preview [documentation written using DocC](https://www.swift.org/documentation/docc/) directly in VS Code.
+You can preview [documentation written using DocC](https://www.swift.org/documentation/docc/) directly in VS Code by using the Preview Swift Documentation button at the top right of an editor, or by invoking `Swift: Preview Documentation` in the command palette in a `.docc` bundle.
 
 Note: This feature requires Swift 6.2 or later.

assets/walkthrough/images/runSwiftExecutable.png

@@ -1,11 +1,16 @@
-# Run Swift Executable
-![Run swift executable](./images/runExecutable.gif)
+# Run Swift Executables
+![Runing a swift executable](./images/runExecutable.gif)
 
-You can run a Swift binary target via the:
-1. Code lens that appears in the `.swift` file 
-2. Project Panel in the bottom left hand corner of the sidebar
-3. Tasks command: You can configure the build tasks through the `launch.json` file in the `.vscode` folder for the project
+You can build and run a Swift binary target via the:
+1. `Run` or `Debug` CodeLens that appears in the `.swift` file that contains your program's entry point
+2. `Project Panel` in the bottom left hand corner of the sidebar under the `Targets` and `Tasks` groups
+3. `Tasks` command: You can configure the build tasks through the `launch.json` file in the `.vscode` folder for the project and then select the target you'd like to build with the `Tasks: Run Task` command from the `Command Pallete`
+4. `Run Swift executable` editor action in the top right corner of the editor
+![Run Swift executable](./images/runSwiftExecutable.png)
 
-![Debug Swift Executable](./images/debugExecutable.gif)
 
-You can debug a target by setting a breakpoint and clicking the the ``Debug Swift Executable`` button on the tab bar or through the ``Run and Debug panel`` in the sidebar.
+# Debug Swift Executables
+
+![Debuging a swift executable](./images/debugExecutable.gif)
+
+The extension automatically generates the debug and release variants of launch configurations in `launch.json`. You can debug a target by setting a breakpoint and clicking the the `Debug Swift Executable` editor action or through the `Run and Debug` panel in the sidebar.

assets/walkthrough/images/runTests.gif

@@ -1,4 +1,7 @@
 # Run Swift Testing and XCTest Tests
 ![Run a test](./images/runTests.gif)
 
-XCTests and Swift Testing tests are detected automatically. You can run them by clicking the ▶ button, with the `Run Test` code lens or through the `Test Explorer` in the sidebar.
+Swift Testing and XCTests tests are detected automatically. You can run tests by:
+1. Clicking the ▶ button or right clicking ▶ button beside the line number, and selecting a test variant such as `Debug Test` or `Run with Coverage`
+2. Clicking `Run`, `Debug` or `Run w/ Coverage` in the CodeLens
+3. Using the `Test Explorer` in the sidebar