Skip to content

Latest commit

 

History

History
77 lines (57 loc) · 3.52 KB

CONTRIBUTING.md

File metadata and controls

77 lines (57 loc) · 3.52 KB
Raw

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://opensource.microsoft.com/cla.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repositories using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

Coding Style

There is an .editorconfig file in the root of the project specifying some simple formatting guidelines. In addition to adhering to those, you should follow the pattern of what you see in existing code where possible.

Code Overview

The repository is organized into a set of different extensions, as outlined in the Readme.

Updating an Extension

Contributions to existing extensions are appreciated.

Any update will need to increment the version in the task's task.json and vss-extension.json files. The version numbers follow the Semantic Versioning rules.

Adding an Extension

If you wish to create a new extension, please discuss this beforehand using GitHub issues.

The following instructions can be used for adding an extension.

  1. If instances of the extension category do not already exist in the repository, create a new folder for this category.
  2. Within the category folder, create a new folder with the name of the extension.
  3. Follow the existing examples as well as the instructions at Microsoft Docs.
  4. Add your custom logic.
  5. Update the GitHub Actions to reference your new extension.

Documentation

Contributions to documentation are always appreciated. Feel free to submit a pull request to contribute to any existing documentation file. If you wish to add new documentation, please add it to the docs folder.

Communicating with the Team

The easiest way to communicate with the team is via GitHub issues. Feel free to file bug reports, feature requests, and suggestions.

Useful References