Merge remote-tracking branch 'Parent/main' into Current

CodeEditorLand · Jul 5, 2024 · 3ff1469 · 3ff1469
2 parents a4104d5 + 6733f39
commit 3ff1469
Show file tree

Hide file tree

Showing 251 changed files with 4,076 additions and 363 deletions.
diff --git a/.devcontainer/Dockerfile b/.devcontainer/Dockerfile
@@ -0,0 +1,8 @@
+FROM mcr.microsoft.com/vscode/devcontainers/base:0-debian-10
+
+# Install Git LFS, add a locale
+RUN apt-get update && DEBIAN_FRONTEND=noninteractive \
+    && apt-get install -yq git-lfs \
+    && git lfs install \
+    && apt-get clean -y && rm -rf /var/lib/apt/lists/*
+
diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
@@ -0,0 +1,16 @@
+// For format details, see https://aka.ms/vscode-remote/devcontainer.json
+{
+	"name": "VS Code Docs",
+	"dockerFile": "Dockerfile",
+	"settings": {
+		"terminal.integrated.defaultProfile.linux": "zsh"
+	},
+	"extensions": [
+		"yzhang.markdown-all-in-one",
+		"streetsidesoftware.code-spell-checker",
+		"DavidAnson.vscode-markdownlint",
+		"bierner.github-markdown-preview",
+		"github.vscode-pull-request-github"
+	],
+	"remoteUser": "vscode"
+}
diff --git a/.editorconfig b/.editorconfig
@@ -0,0 +1,5 @@
+root = true
+
+[*]
+end_of_line = lf
+trim_trailing_whitespace = true
diff --git a/.eslintrc.json b/.eslintrc.json
@@ -0,0 +1,17 @@
+{
+  "env": {
+    "browser": true,
+    "commonjs": true,
+    "es6": true,
+    "node": true,
+    "jquery": true
+  },
+  "extends": [
+    "plugin:security/recommended"
+  ],
+  "parserOptions": {
+    "ecmaVersion": 6,
+    "sourceType": "module"
+  },
+  "root": true
+}
diff --git a/.husky/post-checkout b/.husky/post-checkout
@@ -0,0 +1,3 @@
+#!/bin/sh
+command -v git-lfs >/dev/null 2>&1 || { echo >&2 "\nThis repository is configured for Git LFS but 'git-lfs' was not found on your path. If you no longer wish to use Git LFS, remove this hook by deleting the 'post-checkout' file in the hooks directory (set by 'core.hookspath'; usually '.git/hooks').\n"; exit 2; }
+git lfs post-checkout "$@"
diff --git a/.husky/post-commit b/.husky/post-commit
@@ -0,0 +1,3 @@
+#!/bin/sh
+command -v git-lfs >/dev/null 2>&1 || { echo >&2 "\nThis repository is configured for Git LFS but 'git-lfs' was not found on your path. If you no longer wish to use Git LFS, remove this hook by deleting the 'post-commit' file in the hooks directory (set by 'core.hookspath'; usually '.git/hooks').\n"; exit 2; }
+git lfs post-commit "$@"
diff --git a/.husky/post-merge b/.husky/post-merge
@@ -0,0 +1,3 @@
+#!/bin/sh
+command -v git-lfs >/dev/null 2>&1 || { echo >&2 "\nThis repository is configured for Git LFS but 'git-lfs' was not found on your path. If you no longer wish to use Git LFS, remove this hook by deleting the 'post-merge' file in the hooks directory (set by 'core.hookspath'; usually '.git/hooks').\n"; exit 2; }
+git lfs post-merge "$@"
diff --git a/.husky/pre-commit b/.husky/pre-commit
@@ -0,0 +1,4 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+./node_modules/.bin/lint-staged
diff --git a/.husky/pre-push b/.husky/pre-push
@@ -0,0 +1,3 @@
+#!/bin/sh
+command -v git-lfs >/dev/null 2>&1 || { echo >&2 "\nThis repository is configured for Git LFS but 'git-lfs' was not found on your path. If you no longer wish to use Git LFS, remove this hook by deleting the 'pre-push' file in the hooks directory (set by 'core.hookspath'; usually '.git/hooks').\n"; exit 2; }
+git lfs pre-push "$@"
diff --git a/.prettierignore b/.prettierignore
@@ -0,0 +1,2 @@
+# Ignore all Markdown files:
+*.md
diff --git a/.vscode/release-notes-snippets.code-snippets b/.vscode/release-notes-snippets.code-snippets
@@ -0,0 +1,17 @@
+{
+	// Place your vscode-docs workspace snippets here. Each snippet is defined under a snippet name and has a scope, prefix, body and
+	// description. Add comma separated ids of the languages where the snippet is applicable in the scope field. If scope
+	// is left empty or omitted, the snippet gets applied to all languages. The prefix is what is
+	// used to trigger the snippet and the body will be expanded and inserted. Possible variables are:
+	// $1, $2 for tab stops, $0 for the final cursor position, and ${1:label}, ${2:another} for placeholders.
+	// Placeholders with the same ids are connected.
+	// Example:
+	"code-setting": {
+		"scope": "markdown",
+		"prefix": "setting",
+		"body": [
+			"<code codesetting=\"$1${2::${3:value}}\">$1</code>"
+		],
+		"description": "Interactive VS Code Setting"
+	}
+}
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -0,0 +1,29 @@
+// Place your settings in this file to overwrite default and user settings.
+{
+  "git.branchProtection": [
+    "main"
+  ],
+  "git.branchProtectionPrompt": "alwaysCommitToNewBranch",
+  "editor.wordWrap": "on",
+    "files.eol": "\n",
+    "files.trimTrailingWhitespace": true,
+    "files.associations": {
+        "**/toc.json": "jsonc"
+    },
+    "markdown.validate.enabled": true,
+    "markdown.validate.ignoredLinks": [
+        "/Download",
+        "/insiders"
+    ],
+    "markdown.copyFiles.destination": {
+        // /release-notes/v123.md -> /release-notes/images/123/img.png
+        "/release-notes/**/*": "/release-notes/images/${documentBaseName/v(.*)/$1/}/",
+
+        // Put into 'images' directory next to file
+        "/api/**/*": "images/${documentBaseName}/"
+    },
+    "editor.codeActionsOnSave": {
+        "source.organizeLinkDefinitions": "explicit"
+    },
+    "markdown.editor.filePaste.videoSnippet": "<video src=\"${src}\" title=\"${title}\" autoplay loop controls muted></video>"
+}
diff --git a/LICENSE.md b/LICENSE.md
@@ -0,0 +1,6 @@
+Copyright (c) Microsoft Corporation. All rights reserved. Distributed under the following terms:
+
+1.	Documentation is licensed under the [Creative Commons Attribution 3.0 United States License](https://creativecommons.org/licenses/by/3.0/us/legalcode). Code is licensed under the [MIT License](https://opensource.org/licenses/MIT).
+
+2.	This license does not grant you rights to use any trademarks or logos of Microsoft. For Microsoft’s general trademark guidelines, go to  https://go.microsoft.com/fwlink/?LinkID=254653.
+
diff --git a/api/.prettierrc.json b/api/.prettierrc.json
@@ -0,0 +1,5 @@
+{
+  "printWidth": 92,
+  "tabWidth": 2,
+  "singleQuote": true
+}
diff --git a/api/advanced-topics/extension-host.md b/api/advanced-topics/extension-host.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: 106AA11C-DB26-493A-9E3C-16F513B2AEC8
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: The Visual Studio Code Extension Host is responsible for managing extensions and ensuring the stability and performance of Visual Studio Code.

diff --git a/api/advanced-topics/remote-extensions.md b/api/advanced-topics/remote-extensions.md
@@ -1,6 +1,6 @@
 ---
 ContentId: 5c708951-e566-42db-9d97-e9715d95cdd1
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: A guide to adding Visual Studio Code Remote Development and GitHub Codespaces support to extensions

diff --git a/api/advanced-topics/tslint-eslint-migration.md b/api/advanced-topics/tslint-eslint-migration.md
@@ -1,6 +1,6 @@
 ---
 ContentId: f00c4913-58e3-4a61-aa42-e769c3430906
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: A guide to migrating extension projects from the TSLint linter to ESLint.

diff --git a/api/advanced-topics/using-proposed-api.md b/api/advanced-topics/using-proposed-api.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: f4d4e9e0-8901-405c-aaf5-faa16c32588b
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: Use Visual Studio Code's Proposed API

diff --git a/api/extension-capabilities/common-capabilities.md b/api/extension-capabilities/common-capabilities.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: 9c48dfbf-e49d-4f33-aadc-5ebf06d5dde0
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: Common capabilities that Visual Studio Code extensions (plug-ins) can take advantage of

diff --git a/api/extension-capabilities/extending-workbench.md b/api/extension-capabilities/extending-workbench.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: e0d5bd37-f020-4235-ad81-c977baaeb24f
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: Explain how to extend Visual Studio Code's workbench area with custom UI components

diff --git a/api/extension-capabilities/overview.md b/api/extension-capabilities/overview.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: d22675fc-6609-43f2-a66b-8f2a52597195
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: Learn the details of what's possible with Visual Studio Code's rich extension (plug-in) API.

diff --git a/api/extension-capabilities/theming.md b/api/extension-capabilities/theming.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: 37b6ae0a-d1b5-48b6-9bd4-9b50ef11d573
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: Learn how to add custom themes for colors and icons in Visual Studio Code.

diff --git a/api/extension-guides/chat.md b/api/extension-guides/chat.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: ac3f00c8-78a8-408c-8af6-3e997a482972
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: A guide to creating an AI extension in Visual Studio Code

diff --git a/api/extension-guides/color-theme.md b/api/extension-guides/color-theme.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: 113b458a-3692-4ccf-a181-048bd572a120
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: A guide to creating Color Theme in Visual Studio Code

diff --git a/api/extension-guides/command.md b/api/extension-guides/command.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: 995c7085-5fc0-44e0-a171-30a759c0b7da
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: A guide to using commands programmatically in Visual Studio Code extensions (plug-ins)

diff --git a/api/extension-guides/custom-data-extension.md b/api/extension-guides/custom-data-extension.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: d40b8849-6a4e-428c-b463-c8d61f18136f
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: Learn how to extend Visual Studio Code's HTML and CSS language support.

diff --git a/api/extension-guides/custom-editors.md b/api/extension-guides/custom-editors.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: 6eb86aa4-0f4c-4168-b34a-6ec6b204e960
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: Use the Custom Editor API to create customizable editors within Visual Studio Code.

diff --git a/api/extension-guides/debugger-extension.md b/api/extension-guides/debugger-extension.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: 49EF49AD-8BE6-4D46-ADC8-D678BDC04E85
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: Learn how to provide debugger extensions (plug-ins) for Visual Studio Code through a Debug Adapter.

diff --git a/api/extension-guides/file-icon-theme.md b/api/extension-guides/file-icon-theme.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: f470466d-89b0-4115-ab7a-2448023b0a6d
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: A guide to creating a File Icon Theme in Visual Studio Code

diff --git a/api/extension-guides/images/webview/retainContextWhenHidden.gif b/api/extension-guides/images/webview/retainContextWhenHidden.gif
diff --git a/api/extension-guides/language-model.md b/api/extension-guides/language-model.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: 9bdc3d4e-e6ba-43d3-bd09-2e127cb63ce7
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: A guide to adding AI-powered features to a VS Code extension by using language models and natural language understanding.

diff --git a/api/extension-guides/markdown-extension.md b/api/extension-guides/markdown-extension.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: 1664249a-ba7a-4a53-b3f0-9d757cff7d27
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: Learn how to extend Visual Studio Code's built-in Markdown preview.

diff --git a/api/extension-guides/notebook.md b/api/extension-guides/notebook.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: 535b4d05-c2c8-424a-b075-2cd91566b8da
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: Use the Notebook API to create rich Notebook experiences within Visual Studio Code.

diff --git a/api/extension-guides/overview.md b/api/extension-guides/overview.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: B32601A8-27ED-4D97-BA83-F1C8C945C635
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: Learn from Visual Studio Code extension guides and code samples

diff --git a/api/extension-guides/product-icon-theme.md b/api/extension-guides/product-icon-theme.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: f470466d-89b0-4115-ab7a-2448023b0a6d
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: A guide to creating Product Icon Theme in Visual Studio Code

diff --git a/api/extension-guides/scm-provider.md b/api/extension-guides/scm-provider.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: 79996489-8D16-4C0A-8BE8-FF4B1E9C223A
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: A guide illustrating how to use Source Control API.

diff --git a/api/extension-guides/task-provider.md b/api/extension-guides/task-provider.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: 49744351-83ef-4ef6-99e7-2485e6e9c79f
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: Learn how to contribute tasks to Visual Studio Code through an extension (plug-in).

diff --git a/api/extension-guides/telemetry.md b/api/extension-guides/telemetry.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: b31344d9-a1d9-4f87-82df-9c7151ef99e3
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: Learn how Visual Studio Code extensions can enable telemetry and respect user telemetry choices.

diff --git a/api/extension-guides/testing.md b/api/extension-guides/testing.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: 4ced0b2a-3f5a-44e6-a8b0-66b9012af8c0
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: Testing APIs in VS Code allow users to discover and run unit tests in their workspace

diff --git a/api/extension-guides/tree-view.md b/api/extension-guides/tree-view.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: 9b10cda2-4eb0-4989-8f82-23a46b96c1bb
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: A guide to using Tree View in Visual Studio Code extension (plug-in).

diff --git a/api/extension-guides/virtual-documents.md b/api/extension-guides/virtual-documents.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: 54fdcc33-7ad1-40cc-bc87-ded1841d01ad
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: A guide to using Virtual Documents in Visual Studio Code extensions (plug-ins)

diff --git a/api/extension-guides/virtual-workspaces.md b/api/extension-guides/virtual-workspaces.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: c64264b1-09cd-4680-b0dc-9f0f7803e451
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: Learn how to support virtual workspaces in extensions

diff --git a/api/extension-guides/web-extensions.md b/api/extension-guides/web-extensions.md
@@ -1,7 +1,7 @@
 ---
 # DO NOT TOUCH — Managed by doc writer
 ContentId: 282670bb-cc72-4b01-9b51-08bf8f5a13a1
-DateApproved: 06/05/2024
+DateApproved: 07/03/2024
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
 MetaDescription: Learn how to run extensions in Visual Studio Code for the web and the web extension host.