doc: fix documentation

Author: hverlin

docs/src/content/docs/reference/mise.toml-language-support.md

@@ -9,8 +9,8 @@ sidebar:
 
 For the best experience with syntax highlighting and autocompletion in `mise.toml` files, you should install one of these TOML extensions:
 
-- [Even Better TOML](https://marketplace.visualstudio.com/items?itemName=tamasfe.even-better-toml) (recommended)
 - [Tombi TOML](https://marketplace.visualstudio.com/items?itemName=tombi-toml.tombi)
+- [Even Better TOML](https://marketplace.visualstudio.com/items?itemName=tamasfe.even-better-toml)
 
 The extension will notify you on startup if neither is installed.
 

docs/src/content/docs/tutorials/Getting-Started.mdx

@@ -13,8 +13,8 @@ import { Steps } from '@astrojs/starlight/components';
    [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=hverlin.mise-vscode#overview)
    or [Open VSX](https://open-vsx.org/extension/hverlin/mise-vscode)
 1. **Recommended:** Install a TOML extension for syntax highlighting and autocompletion:
-  - [Tombi TOML](https://marketplace.visualstudio.com/items?itemName=tombi-toml.tombi)
-  - [Even Better TOML](https://marketplace.visualstudio.com/items?itemName=tamasfe.even-better-toml) (works well but [not actively maintained anymore](https://github.com/tamasfe/taplo/issues/715)). The extension will notify you if neither is installed.
+  [Tombi TOML](https://marketplace.visualstudio.com/items?itemName=tombi-toml.tombi) or
+  [Even Better TOML](https://marketplace.visualstudio.com/items?itemName=tamasfe.even-better-toml). The extension will notify you if neither is installed.
 1. Open a project with a `mise.toml` file (or any other files supported by mise)
 
 </Steps>

package.json

@@ -200,7 +200,7 @@
 					"type": "boolean",
 					"title": "Configure extensions to use symlinks",
 					"default": false,
-					"markdownDescription": "Create symlinks in your `.vscode` folder that links to the `mise` bin. This is useful if you share the `.vscode/settings.json` file with others."
+					"markdownDescription": "Create symlinks in your `.vscode` folder that links to the `mise` bin.\n\nThis is useful if you share the `.vscode/settings.json` file with others. When the project is version controlled:\n- every user must have the extension installed\n- the directory `.vscode/mise-tools` must be excluded from version control."
 				},
 				"mise.enableCodeLens": {
 					"order": 8,