docs: update integration doc with details of extension config namespace change (#2428)

* docs: update integration doc with details of extension config namespace change

* docs: add descriptions of sorting modes

website/src/docs/integrations.md

@@ -12,9 +12,9 @@ outline: deep
 
 Task has an
 [official extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=task.vscode-task).
-The code for this project can be found
-[here](https://github.com/go-task/vscode-task). To use this extension, you must
-have Task v3.23.0+ installed on your system.
+The code for this project can be found in
+[our GitHub repository](https://github.com/go-task/vscode-task). To use this
+extension, you must have Task v3.45.3+ installed on your system.
 
 This extension provides the following features (and more):
 
@@ -30,6 +30,19 @@ To get autocompletion and validation for your Taskfile, see the
 
 ![Task for Visual Studio Code](https://github.com/go-task/vscode-task/blob/main/res/preview.png?raw=true)
 
+### Configuration namespace change
+
+In v1.0.0 of the extension, the configuration namespace was changed from `task`
+to `taskfile` in order to fix
+[an issue](https://github.com/go-task/vscode-task/issues/56).
+
+![Configuration namespace change warning](../public/img/config-namespace-change.png)
+
+If you receive a warning like the one above, you will need to update your
+settings to use the new `taskfile` namespace instead:
+
+![Configuration namespace diff](../public/img/config-namespace-diff.png)
+
 ## Schema
 
 This was initially created by @KROSF in

website/src/docs/reference/cli.md

@@ -118,7 +118,8 @@ task deploy --silent
 
 #### `--disable-fuzzy`
 
-Disable fuzzy matching for task names. When enabled, Task will not suggest similar task names when you mistype a task name.
+Disable fuzzy matching for task names. When enabled, Task will not suggest
+similar task names when you mistype a task name.
 
 ```bash
 task buidl --disable-fuzzy
@@ -274,7 +275,12 @@ task --list --json
 
 #### `--sort <mode>`
 
-Change task listing order. Available modes: `default`, `alphanumeric`, `none`.
+Change task listing order. Available modes:
+
+- `default` - Sorts tasks alphabetically by name, but ensures that root tasks
+  (tasks without a namespace) are listed before namespaced tasks.
+- `alphanumeric` - Sort tasks alphabetically by name.
+- `none` - No sorting. Uses the order as defined in the Taskfile.
 
 ```bash
 task --list --sort alphanumeric
@@ -314,9 +320,9 @@ task deploy --yes
 Enable interactive prompts for missing required variables. When a required
 variable is not provided, Task will prompt for input instead of failing.
 
-Task automatically detects non-TTY environments (like CI pipelines) and
-skips prompts. This flag can also be set in `.taskrc.yml` to enable prompts
-by default.
+Task automatically detects non-TTY environments (like CI pipelines) and skips
+prompts. This flag can also be set in `.taskrc.yml` to enable prompts by
+default.
 
 ```bash
 task deploy --interactive