Document Marketplace installation for the VS Code extension

.github/workflows/validate.yml

@@ -21,13 +21,15 @@ jobs:
       # The first project's page runs DuckDB; its test runs the page's DuckDB steps
       # with the version the DuckDB pack is tested with. The checksum is the
       # release asset's SHA-256, as GitHub records it for duckdb/duckdb v1.5.6.
+      # Use the asset API because the github.com download redirect can time out.
       - name: Install the DuckDB command line
         env:
-          DUCKDB_VERSION: 1.5.6
+          DUCKDB_ASSET_ID: 595495137
           DUCKDB_SHA256: 6e89deac1ebbc36eed0291caf8b567b030c7b86ac35998f71854e22b3c5d5e2f
         run: |
           curl -fsSL --retry 3 -o "$RUNNER_TEMP/duckdb.zip" \
-            "https://github.com/duckdb/duckdb/releases/download/v${DUCKDB_VERSION}/duckdb_cli-linux-amd64.zip"
+            -H "Accept: application/octet-stream" \
+            "https://api.github.com/repos/duckdb/duckdb/releases/assets/${DUCKDB_ASSET_ID}"
           echo "${DUCKDB_SHA256}  $RUNNER_TEMP/duckdb.zip" | sha256sum -c -
           unzip -q "$RUNNER_TEMP/duckdb.zip" -d "$RUNNER_TEMP/duckdb"
           echo "$RUNNER_TEMP/duckdb" >> "$GITHUB_PATH"

content/docs/(reference)/tools/vscode.mdx

@@ -10,8 +10,10 @@ Check work on every environment together, as the command does.
 
 ## Install
 
-Follow [Install the command and the extension](/docs/start/install) to build the extension from
-[ingestron/vscode](https://github.com/ingestron/vscode) and install it.
+Install [Ingestron from the Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=ingestron.ingestron-vscode).
+You need VS Code 1.104 or later. See
+[Install the command and the extension](/docs/start/install) for installation
+steps and how to check that it is ready.
 
 Open a folder that holds an Ingestron project. The selected environment
 appears in the status bar, such as `Ingestron: dev`; click it to choose

content/docs/start/install.mdx

@@ -29,22 +29,22 @@ The [command line reference](/docs/reference/cli) lists every option.
 </Tool>
 <Tool name="VS Code">
 
-The extension is not in the Visual Studio Marketplace yet. Build it from
-[ingestron/vscode](https://github.com/ingestron/vscode) (Node.js 22.13 or later
-and pnpm 10), then install the file it writes:
+You need VS Code 1.104 or later. Install
+[Ingestron from the Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=ingestron.ingestron-vscode),
+or open the Extensions view, search for `@id:ingestron.ingestron-vscode` and
+select **Install**.
+
+If the `code` command is available in your terminal, you can also run:
 
 ```sh
-git clone https://github.com/ingestron/vscode.git
-cd vscode
-pnpm install
-pnpm package
-code --install-extension ingestron.vsix
+code --install-extension ingestron.ingestron-vscode
 ```
 
-Alternatively, use **Extensions: Install from VSIX…** to select
-`ingestron.vsix`. After installation, the Command Palette should include
-**Ingestron: New project**. See [VS Code](/docs/tools/vscode) for editor
-features.
+After installation, the Command Palette should include **Ingestron: New
+project**. Run it to create a project, or open a folder that holds a
+`project.yaml`. The extension includes the Ingestron packages it uses; you do
+not need to install the CLI separately to use its editor features. See
+[VS Code](/docs/tools/vscode) for the available commands and views.
 
 </Tool>
 </ToolSteps>
@@ -65,6 +65,8 @@ alias ingestron="node $PWD/packages/cli/dist/main.js"
 
 The platform packs, the extension and this site each have their own
 repository in the [ingestron organisation](https://github.com/ingestron).
+To build the extension and install a local VSIX, follow the
+[extension development instructions](https://github.com/ingestron/vscode#develop).
 
 ## Verify the workflow