Skip to content

Omairy12/vscode-docs

This branch is 816 commits behind microsoft/vscode-docs:main.

Folders and files

NameName
Last commit message
Last commit date
May 15, 2023
Sep 19, 2022
Sep 7, 2023
Nov 22, 2024
Feb 22, 2024
Dec 1, 2024
Nov 15, 2024
Nov 15, 2024
Dec 3, 2024
Jan 26, 2022
Oct 29, 2024
Nov 13, 2024
Oct 1, 2024
Oct 29, 2024
Mar 11, 2019
Mar 11, 2019
Jul 17, 2023
Mar 19, 2024
Mar 11, 2019
Feb 28, 2022
Sep 16, 2024
Mar 11, 2019
Oct 7, 2024
May 18, 2022
Jul 3, 2024
Oct 1, 2024
Oct 1, 2024
Oct 1, 2024

Repository files navigation

vscode logo

Visual Studio Code Documentation

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.

Note: The vscode-docs repository uses Git LFS (Large File Storage) for storing binary files such as images and .gifs. If you are contributing or updating images, please enable Git LFS per the instructions in the Contributing section below.

Index

Visual Studio Code

VS Code is a lightweight source code editor and powerful development environment for building and debugging modern web, mobile, 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.

Feedback

If you want to give documentation feedback, please use the feedback control located at the bottom of each documentation page.

Documentation Issues

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.

Contributing

To contribute new topics/information or make changes to existing documentation, please read the Contributing Guideline.

Workflow

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.

Markdown Preview Button

Cloning

  1. Install Git LFS.
  2. Run git lfs install to setup global git hooks. You only need to run this once per machine.
  3. SSH auth: git clone [email protected]:microsoft/vscode-docs.git
    HTTPS auth: git clone https://github.com/microsoft/vscode-docs.git
  4. Now you can git add binary files and commit them. They'll be tracked in LFS.

Cloning without binary files

You might want to clone the repo without the 1.6GB images. Here are the steps:

  1. Install Git LFS.
  2. Run git lfs install to setup global git hooks. You only need to run this once per machine.
  3. Clone the repo without binary files.
    • macOS / Linux:
      • SSH auth: GIT_LFS_SKIP_SMUDGE=1 git clone [email protected]:microsoft/vscode-docs.git
      • HTTPS auth: GIT_LFS_SKIP_SMUDGE=1 git clone https://github.com/microsoft/vscode-docs.git
    • Windows:
      • SSH auth: $env:GIT_LFS_SKIP_SMUDGE="1"; git clone [email protected]:microsoft/vscode-docs.git
      • HTTPS auth: $env:GIT_LFS_SKIP_SMUDGE="1"; git clone https://github.com/microsoft/vscode-docs.git
  4. Now you can selectively checkout some binary files to work with. For example:
    • git lfs pull -I "docs/nodejs" to only download images in docs/nodejs
    • git lfs pull -I "release-notes/images/1_4*/*" to only download images in release-notes/images/1_4*
    • git lfs pull -I "docs,api" to download all images in docs and in api
    • git lfs pull -I <PATTERN>, as long as <PATTERN> is a valid Git LFS Include and Exclude pattern.

The history of this repo before we adopted LFS can be found at microsoft/vscode-docs-archive.

Publishing

Publishing merged pull requests is not automatic and is initiated manually after changes have been reviewed on an internal staging server. There is no specific time guarantee for when PR updates will be available on https://code.visualstudio.com but the intent is that they will usually be live within 24 hours.

About

Public documentation for Visual Studio Code

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Markdown 100.0%