Hi there! We're delighted that you'd like to contribute to the Git Diff Margin. Your help is appreciated and essential for keeping Git Diff Margin great.
Contributions to this project are released to the public under the project's open source license.
Please note that this project is released with a Contributor Covenant Code of Conduct. By participating in this project you agree to abide by its terms.
Do you have a feature that you think would be a great addition to Git Diff Margin, please verify first that we do not have something similar in our issues labeled feature. Also take a peek at our pull requests to see what we're currently working on. To suggest a feature use the feature request template.
- Fork and clone the Git Diff Margin repository.
- Create a new branch:
git checkout -b my-branch-name
. - Make your change, add tests, and make sure the tests still pass.
- Push to your fork and submit a pull request.
- That's it! Your pull request will be reviewed, discussed if needed and finally merged when ready.
Here are a few things you can do that will increase the likelihood of your pull request being accepted:
- Follow the style/format of the existing code.
- Keep your change as focused as possible. If there are multiple changes you would like to make that are not dependent upon each other, consider submitting them as separate pull requests.
- Write tests for your changes.
- Write a good commit message.
Here are a few helpful tips when reporting a bug:
- Verify that the bug resides in Git Diff Margin extension.
- If the bug is not related to the Git Diff Margin extension, visit the Visual Studio support page for help.
- To report a bug use the bug report template.
- Screenshots are very helpful in diagnosing bugs and understanding the state of the extension when it's experiencing problems. Please include them whenever possible.
- A log file is helpful in diagnosing bug issues.
To include log files in your issue:
- Close Visual Studio if it's open
- Open a Developer Command Prompt for VS2017
- Run devenv /log
- Reproduce your issue
- Close VS
- Locate the following file on your system and create a gist and link it in the issue report:
%appdata%\Microsoft\VisualStudio\15.0\ActivityLog.xml