Skip to content

Commit eabfff3

Browse files
ntroghntrogh
committed
Merge remote-tracking branch 'public-docs/main' into vnext
2 parents b36242f + 27e6951 commit eabfff3

File tree

5,409 files changed

+18414
-1110
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

5,409 files changed

+18414
-1110
lines changed

‎.husky/pre-commit

100644100755
File mode changed.

‎.pipelines/azure-pipelines.main.yml

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
trigger:
2+
batch: true
3+
branches:
4+
include:
5+
- main
6+
paths:
7+
exclude:
8+
- .config
9+
- .devcontainer
10+
- .pipelines
11+
- .vscode
12+
pr: none
13+
14+
resources:
15+
repositories:
16+
- repository: 1esPipelines
17+
type: git
18+
name: 1ESPipelineTemplates/1ESPipelineTemplates
19+
ref: refs/tags/release
20+
21+
pipelines:
22+
- pipeline: vscode-website-prod
23+
source: vscode-website (official)
24+
branch: release/prod
25+
trigger: true
26+
27+
variables:
28+
Codeql.Enabled: true
29+
Codeql.SourceRoot: $(Pipeline.Workspace)/vscode-website
30+
Codeql.TSAEnabled: true
31+
Codeql.TSAOptionsPath: $(Build.SourcesDirectory)/.config/tsaoptions.json
32+
33+
extends:
34+
template: v1/1ES.Official.PipelineTemplate.yml@1esPipelines
35+
parameters:
36+
sdl:
37+
credscan:
38+
suppressionsFile: $(Build.SourcesDirectory)/.config/CredScanSuppressions.json
39+
git:
40+
fetchDepth: 1
41+
lfs: true
42+
retryCount: 3
43+
policheck:
44+
break: true
45+
sourceAnalysisPool: 1es-windows-2022-x64
46+
tsa:
47+
enabled: true
48+
49+
stages:
50+
- template: templates/stages/build-main.yml@self

‎.pipelines/azure-pipelines.vnext.yml

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
trigger:
2+
batch: true
3+
branches:
4+
include:
5+
- vnext
6+
paths:
7+
exclude:
8+
- .config
9+
- .devcontainer
10+
- .pipelines
11+
- .vscode
12+
pr: none
13+
14+
resources:
15+
repositories:
16+
- repository: 1esPipelines
17+
type: git
18+
name: 1ESPipelineTemplates/1ESPipelineTemplates
19+
ref: refs/tags/release
20+
21+
pipelines:
22+
- pipeline: vscode-website-main
23+
source: vscode-website (buddy)
24+
branch: main
25+
trigger: true
26+
27+
extends:
28+
template: v1/1ES.Official.PipelineTemplate.yml@1esPipelines
29+
parameters:
30+
sdl:
31+
credscan:
32+
suppressionsFile: $(Build.SourcesDirectory)/.config/CredScanSuppressions.json
33+
git:
34+
fetchDepth: 1
35+
lfs: true
36+
retryCount: 3
37+
policheck:
38+
break: true
39+
sourceAnalysisPool: 1es-windows-2022-x64
40+
tsa:
41+
enabled: true
42+
43+
stages:
44+
- template: templates/stages/build-vnext.yml@self

‎.pipelines/templates/stages/build-main.yml

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
stages:
2+
- stage: Build
3+
jobs:
4+
- template: ../jobs/build.yml@self
5+
parameters:
6+
jobDisplayName: vscode-site-prod
7+
artifactName: vscode-website-prod

‎.pipelines/templates/stages/build-vnext.yml

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
stages:
2+
- stage: Build
3+
jobs:
4+
- template: ../jobs/build.yml@self
5+
parameters:
6+
jobDisplayName: vscode-site-vnext
7+
artifactName: vscode-website-main

‎api/advanced-topics/extension-host.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
# DO NOT TOUCH — Managed by doc writer
33
ContentId: 106AA11C-DB26-493A-9E3C-16F513B2AEC8
4-
DateApproved: 10/03/2024
4+
DateApproved: 10/29/2024
55

66
# Summarize the whole topic in less than 300 characters for SEO purpose
77
MetaDescription: The Visual Studio Code Extension Host is responsible for managing extensions and ensuring the stability and performance of Visual Studio Code.

‎api/advanced-topics/remote-extensions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
ContentId: 5c708951-e566-42db-9d97-e9715d95cdd1
3-
DateApproved: 10/03/2024
3+
DateApproved: 10/29/2024
44

55
# Summarize the whole topic in less than 300 characters for SEO purpose
66
MetaDescription: A guide to adding Visual Studio Code Remote Development and GitHub Codespaces support to extensions

‎api/advanced-topics/tslint-eslint-migration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
ContentId: f00c4913-58e3-4a61-aa42-e769c3430906
3-
DateApproved: 10/03/2024
3+
DateApproved: 10/29/2024
44

55
# Summarize the whole topic in less than 300 characters for SEO purpose
66
MetaDescription: A guide to migrating extension projects from the TSLint linter to ESLint.

‎api/advanced-topics/using-proposed-api.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
# DO NOT TOUCH — Managed by doc writer
33
ContentId: f4d4e9e0-8901-405c-aaf5-faa16c32588b
4-
DateApproved: 10/03/2024
4+
DateApproved: 10/29/2024
55

66
# Summarize the whole topic in less than 300 characters for SEO purpose
77
MetaDescription: Use Visual Studio Code's Proposed API

‎api/extension-capabilities/common-capabilities.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
# DO NOT TOUCH — Managed by doc writer
33
ContentId: 9c48dfbf-e49d-4f33-aadc-5ebf06d5dde0
4-
DateApproved: 10/03/2024
4+
DateApproved: 10/29/2024
55

66
# Summarize the whole topic in less than 300 characters for SEO purpose
77
MetaDescription: Common capabilities that Visual Studio Code extensions (plug-ins) can take advantage of
@@ -36,12 +36,13 @@ An extension can register custom Context Menu items that will be displayed in di
3636

3737
## Data Storage
3838

39-
There are four options for storing data:
39+
There are five options for storing data:
4040

4141
- [`ExtensionContext.workspaceState`](/api/references/vscode-api#ExtensionContext.workspaceState): A workspace storage where you can write key/value pairs. VS Code manages the storage and will restore it when the same workspace is opened again.
4242
- [`ExtensionContext.globalState`](/api/references/vscode-api#ExtensionContext.globalState): A global storage where you can write key/value pairs. VS Code manages the storage and will restore it for each extension activation. You can selectively synchronize key/value pairs in global storage by setting the keys for sync using `setKeysForSync` method on `globalState`.
4343
- [`ExtensionContext.storageUri`](/api/references/vscode-api#ExtensionContext.storageUri): A workspace specific storage URI pointing to a local directory where your extension has read/write access. This is a good option if you need to store large files that are accessible only from the current workspace.
4444
- [`ExtensionContext.globalStorageUri`](/api/references/vscode-api#ExtensionContext.globalStorageUri): A global storage URI pointing to a local directory where your extension has read/write access. This is a good option if you need to store large files that are accessible from all workspaces.
45+
- [`ExtensionContext.secrets`](/api/references/vscode-api#ExtensionContext.secrets): A global storage for secrets (or any information that is sensitive) that will be encrypted. These are not synced across machines. For VS Code desktop, this leverages Electron's [safeStorage API](https://www.electronjs.org/docs/latest/api/safe-storage). For VS Code for the Web, this uses a Double Key Encryption (DKE) implementation.
4546

4647
The extension context is available to the `activate` function in the [Extension Entry File](/api/get-started/extension-anatomy#extension-entry-file).
4748

0 commit comments

Comments
 (0)