Skip to content

Latest commit

 

History

History
161 lines (101 loc) · 6.09 KB

CONTRIBUTING.md

File metadata and controls

161 lines (101 loc) · 6.09 KB
Raw

Contributing

👍🎉 First off, thanks for taking the time to contribute! 🎉👍

When contributing to this project, please first discuss the changes you wish to make via an issue before making changes.

Please note the Code of Conduct document, please follow it in all your interactions with this project.

Your First Code Contribution

Unsure where to begin contributing? You can start by looking through the help-wanted issues.

Getting the code

git clone https://github.com/eamodio/vscode-find-related.git

Prerequisites

Dependencies

From a terminal, where you have cloned the repository, execute the following command to install the required dependencies:

yarn

Build

From a terminal, where you have cloned the repository, execute the following command to re-build the project from scratch:

yarn run rebuild

👉 NOTE! This will run a complete rebuild of the project.

Or to just run a quick build, use:

yarn run build

Watch

During development you can use a watcher to make builds on changes quick and easy. From a terminal, where you have cloned the repository, execute the following command:

yarn run watch

Or use the provided watch task in VS Code, execute the following from the command palette (be sure there is no > at the start):

task watch

This will first do an initial full build and then watch for file changes, compiling those changes incrementally, enabling a fast, iterative coding experience.

👉 Tip! You can press CMD+SHIFT+B (CTRL+SHIFT+B on Windows, Linux) to start the watch task.

👉 Tip! You don't need to stop and restart the development version of Code after each change. You can just execute Reload Window from the command palette.

Formatting

This project uses prettier for code formatting. You can run prettier across the code by calling yarn run pretty from a terminal.

To format the code as you make changes you can install the Prettier - Code formatter extension.

Add the following to your User Settings to run prettier:

"editor.formatOnSave": true,

Linting

This project uses ESLint for code linting. You can run ESLint across the code by calling yarn run lint from a terminal. Warnings from ESLint show up in the Errors and Warnings quick box and you can navigate to them from inside VS Code.

To lint the code as you make changes you can install the ESLint extension.

Bundling

To generate a production bundle (without packaging) run the following from a terminal:

yarn run bundle

To generate a VSIX (installation package) run the following from a terminal:

yarn run package

Debugging

Using VS Code (desktop)

  1. Open the vscode-find-related folder
  2. Ensure the required dependencies are installed
  3. Choose the Watch & Run launch configuration from the launch dropdown in the Run and Debug viewlet and press F5.

Using VS Code (desktop webworker)

  1. Open the vscode-find-related folder
  2. Ensure the required dependencies are installed
  3. Choose the Watch & Run (web) launch configuration from the launch dropdown in the Run and Debug viewlet and press F5.

Using VS Code for the Web (locally)

See https://code.visualstudio.com/api/extension-guides/web-extensions#test-your-web-extension-in-a-browser-using-vscodetestweb

  1. Open the vscode-find-related folder
  2. Ensure the required dependencies are installed
  3. Run the build or watch task from the command palette
  4. Run the Run (local web) task from the command palette

Using VS Code for the Web (vscode.dev)

See https://code.visualstudio.com/api/extension-guides/web-extensions#test-your-web-extension-in-on-vscode.dev

  1. Open the vscode-find-related folder
  2. Ensure the required dependencies are installed
  3. Run the build or watch task from the command palette
  4. Run the Run (vscode.dev) task from the command palette

Submitting a Pull Request

Please follow all the instructions in the PR template.

Update the CHANGELOG

The Change Log is updated manually and an entry should be added for each change. Changes are grouped in lists by added, changed, removed, or fixed.

Entries should be written in future tense:

  • Be sure to give yourself much deserved credit by adding your name and user in the entry

Added

Changed

Fixed

Update the README

If this is your first contribution to Find Related Files, please give yourself credit by adding yourself to the Contributors section of the README in the following format:

  • Your Name ([@<your-github-username>](https://github.com/<your-github-username>)) &mdash; [contributions](https://github.com/eamodio/vscode-find-related/commits?author=<your-github-username>)