Walkthrough (#1709)

* Add an extension walkthrough

Adds a walkthrough to the package.json that guides users through:

- Installing Swift
- Creating a New Project
- Extension Commands
- Running Tests
- Selecting a Toolchain

* Ensure assets are added to .vsix

* Properly theme swiftCommands.svg

* Fixup wording

* Update the walkthrough

Add some GIFs and additional steps for running, debugging and DocC
previewing.

Issue: #1560

* 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

* Simplify create project step

Remove additional details and make the "Try it out" button launch the
swift extension create new project command directly.

* Update changelog

* Remove unused pictures

* Incorporate suggestions from @award999

---------

Co-authored-by: Paul LeMarquand <[email protected]>

Author: rbenegal

.vscodeignore

@@ -9,6 +9,7 @@
 !images/**
 !snippets/**
 !assets/icons/**
+!assets/walkthrough/**
 !assets/documentation-webview/**
 !assets/swift-docc-render/**
 !node_modules/@vscode/codicons/**

CHANGELOG.md

@@ -11,6 +11,7 @@
 
 ### Changed
 - Added log levels and improved Swift extension logging so a logfile is produced in addition to logging messages to the existing `Swift` output channel. Deprecated the `swift.diagnostics` setting in favour of the new `swift.outputChannelLogLevel` setting ([#1746](https://github.com/swiftlang/vscode-swift/pull/1746))
+- A walkthrough for first time extension users ([#1560](https://github.com/swiftlang/vscode-swift/issues/1560))
 
 ## 2.10.0 - 2025-07-28
 

assets/walkthrough/createNewProject.md

@@ -0,0 +1,10 @@
+# Create a New Swift Project
+![Create new project](./images/createNewProject.gif)
+
+When you select a project template, you'll be prompted to enter a name for your new project. This will be the name of the folder created in your workspace. You can then choose any location in your workspace, or create a new folder for the project.
+
+# Opening Existing Projects
+
+![Open existing project](./images/openProject.gif)
+
+When you open an existing project with a ``Package.swift`` file the extension will activate automatically.

assets/walkthrough/customizeSettings.md

@@ -0,0 +1,19 @@
+# Swift Extension Settings
+
+![Swift Extension Settings](./images/settings.gif)
+
+The Swift Extension contains several settings you can customize. You can filter settings Swift extension settings by searching for `@ext:swiftlang.swift-vscode`.
+
+## Language Settings
+
+Some language settings such as those for inlay hints for inferred variable types are turned on by default in VS Code.
+
+![Disable Inlay Hints](./images/disableInlayHints.gif)
+
+You can turn off inlay hints for Swift by adding `[swift]` specific settings to your `settings.json` file:
+
+```
+   "[swift]": {
+        "editor.inlayHints.enabled": "off"
+    },
+```