microsoft/vscode-docs

vscode-docs is a documentation repository that contains the published content for Visual Studio Code's official documentation portal.

The repository serves as the source for all documentation displayed on the Visual Studio Code website. Contributors submit topics and updates here, which are then published to the main documentation portal. The repository uses Git Large File Storage to manage binary assets such as images and animated GIFs, which are substantial in size. The documentation is written in Markdown format, allowing for straightforward editing and version control.

Anyone contributing to or maintaining VS Code's documentation should work with this repository. It suits organizations and individuals who need to keep technical documentation synchronized with a widely-used development tool. The repository provides two contribution workflows: direct editing through GitHub's interface for minor changes, or cloning the repository locally for more substantial revisions and Markdown preview capabilities within VS Code itself. Contributors working with images or GIFs must enable Git LFS to properly track binary files, though the option exists to clone without binary assets if storage is a concern.

The project maintains active issue tracking for documentation bugs through its GitHub issues system, with a clear distinction between documentation problems and product issues. Feedback mechanisms are integrated directly into the published documentation pages, allowing end users to report problems at the point of use. The repository includes detailed contributing guidelines and workflow documentation to support contributors at all levels.