vscode-cmake-tools/CONTRIBUTING.md

How to Contribute to CMake Tools

This article is for developers who want to contribute to the CMake Tools open source project.

Build the CMake Tools extension

As with most VS Code extensions, you'll need Node.JS installed. We use yarn to compile the code (run npm install -g yarn to install it).

The process is:

1. Open the repo in VS Code

2. Press F5 to build and run the extension

Coding guidelines

Formatting

Code is formatted using the default TypeScript formatter in VS Code and uses 4 space indentation.

Linting

We use eslint for linting our sources. You can run eslint across the sources from a terminal or command prompt by running yarn run lint. Warnings from eslint show up in the Errors and Warnings pane and you can navigate to them from inside VS Code. To lint the source as you make changes, install the eslint extension.

Style [Updated!]

Follow the Typescript Coding guidelines.

snake_case was used historically for variables in this repo, but that style is phased out. All new variables should be lowerCamelCase. The existing variables will be migrated to the new naming soon (or you can help out with a pull request!)

Changelog

Please update the CHANGELOG.md file as part of your pull request. Follow the style within that file and give yourself credit for the changes you make.

Adding/Updating package.json dependencies

We maintain a public Azure Artifacts feed that we point the package manager to in the .npmrc file.

Because of this, if you want to add/update a dependency version in package.json, intervention from our team will be required to successfully merge PRs that have dependency updates. Please ping our team in the PR.

For local development before attempting to merge a PR, you can delete the .npmrc file and use the default NPM feed directly. Please do not push any subsequent changes to the yarn.lock file.