You've found the Visual Studio Code documentation GitHub repository, which contains the content for the Visual Studio Code documentation.
Topics submitted here will be published to the Visual Studio Code portal.
If you are looking for the VS Code product GitHub repository, you can find it here.
VS Code is a lightweight source code editor and powerful development environment for building and debugging modern web and cloud applications. It is free and available on your favorite platform - Linux, macOS, and Windows.
If you landed here looking for other information about VS Code, head over to our website for additional information.
If you want to give documentation feedback, please use the feedback control located at the bottom of each documentation page.
To enter documentation bugs, please create a new GitHub issue. Please check if there is an existing issue first.
If you think the issue is with the VS Code product itself, please enter issues in the VS Code product repo here.
To contribute with new topics / information or make changes to existing documentation, please read the Contributing Guideline.
The two suggested workflows are:
- For small changes, use the "Edit" button on each page to edit the Markdown file directly on GitHub.
- If you plan to make significant changes or preview the Markdown files in VS Code, clone the repo to edit and preview the files directly in VS Code.
- Install Git LFS.
- Run
git lfs install
to setup global git hooks. You only need to run this once per machine. git clone [email protected]:Microsoft/vscode-docs.git
.- Now you can
git add
binary files and commit them. They'll be tracked in LFS.
You might want to clone the repo without the 1.6GB images. Here are the steps:
- Install Git LFS.
- Run
git lfs install
to setup global git hooks. You only need to run this once per machine. - Clone the repo without binary files.
- macOS / Linux:
GIT_LFS_SKIP_SMUDGE=1 git clone [email protected]:Microsoft/vscode-docs.git
. - Windows:
$env:GIT_LFS_SKIP_SMUDGE="1"; git clone [email protected]:Microsoft/vscode-docs.git
.
- macOS / Linux:
- Now you can selectively checkout some binary files to work with. For example:
git lfs pull -I "docs/nodejs"
git lfs pull -I "release-notes/images/1_3*/*"
- You can do
git lfs pull -I <PATTERN>
, as long as<PATTERN>
is comma-separated glob strings. For more patterns, see Git LFS: Include and Exclude.
The history of this repo before we adopted LFS can be found at microsoft/vscode-docs-archive.
Steps for how to publish documentation changes can be found here in the (private) repository of the VS Code website.