VisualStudio/CONTRIBUTING.md

72 строки
4.2 KiB
Markdown
Исходник Обычный вид История

2015-07-19 08:15:44 +03:00
## Contributing
[fork]: https://github.com/github/VisualStudio/fork
[pr]: https://github.com/github/VisualStudio/compare
2015-07-31 19:58:34 +03:00
[code-of-conduct]: http://todogroup.org/opencodeofconduct/#VisualStudio/opensource@github.com
[readme]: https://github.com/github/VisualStudio#build
2015-07-19 08:15:44 +03:00
Hi there! We're thrilled that you'd like to contribute to this project. Your help is essential for keeping it great.
This project adheres to the [Open Code of Conduct][code-of-conduct]. By participating, you are expected to uphold this code.
2015-07-19 08:15:44 +03:00
## Submitting a pull request
2015-07-31 19:58:34 +03:00
0. [Fork][] and clone the repository (see Build Instructions in the [README][readme])
2015-07-19 08:15:44 +03:00
0. Create a new branch: `git checkout -b my-branch-name`
0. Make your change, add tests, and make sure the tests still pass
0. Push to your fork and [submit a pull request][pr]
0. Pat your self on the back and wait for your pull request to be reviewed and merged.
Here are a few things you can do that will increase the likelihood of your pull request being accepted:
- Follow the existing code's style.
- Write tests.
- 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 a [good commit message](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html).
There are certain areas of the extension that are restricted in what they can do and what dependencies they can have.
- All sections and navigation items in the various Team Explorer areas are instantiated regardless of whether they're shown, so code in these areas needs to be as lazily run as possible.
- Anything in the Team Explorer Home page is extremely restricted in what dependencies it can have. Code in this area needs to be as fast and as minimal as possible.
- Team Explorer content outside the Home page is slightly less restricted, but not by much
- Dialogs and views that don't inherit from TeamExplorer classes are free to use what they need.
2016-05-30 23:50:04 +03:00
## Submitting an Issue
2016-05-31 21:08:07 +03:00
### Bug Reporting
2016-05-31 21:15:51 +03:00
Here are a few helpful tips when reporting a bug:
- Verify the bug resides in the GitHub for Visual Studio extension
2016-06-02 14:00:49 +03:00
- A lot of functionality provided by this extension resides in the Team Explorer pane, alongside other non-GitHub tools to manage and collaborate on source code, including Visual Studio's Git support, which is owned by Microsoft.
2016-05-31 21:08:07 +03:00
- If this bug not is related to the GitHub extension, visit the [Visual Studio support page](https://www.visualstudio.com/support/support-overview-vs) for help
2016-06-02 14:00:49 +03:00
- 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:
1. Close Visual Studio if it's open
2. Open a Developer Command Prompt for VS2015
3. Run devenv /log
4. Reproduce your issue
5. Close VS
6. Locate the following files on your system and email them to windows@github.com or create a gist and link it in the issue report:
- `%appdata%\Microsoft\VisualStudio\14.0\ActivityLog.xml`
- `%localappdata%\temp\extension.log`
- `%localappdata%\GitHubVisualStudio\extension.log`
2016-05-31 21:08:07 +03:00
### Feature Requests
If you have a feature that you think would be a great addition to the extension, we might already have thought about it too, so be sure to check if your suggestion matches our [roadmap](#roadmap-and-future-feature-ideas) before making a request. Also take a peek at our [pull requests](https://github.com/github/VisualStudio/pulls) to see what we're currently working on. Additionally, someone might have already thought of your idea, so check out Issues labeled as [features](https://github.com/github/VisualStudio/issues?q=is%3Aopen+is%3Aissue+label%3Afeature) to see if it already exists.
2016-05-31 21:08:07 +03:00
2015-07-19 08:15:44 +03:00
## Things to improve in the current version
- [Localization](https://github.com/github/VisualStudio/issues/18)
2015-07-19 08:15:44 +03:00
## Roadmap and future feature ideas
- Pull Requests
- Issues
## Resources
- [Contributing to Open Source on GitHub](https://guides.github.com/activities/contributing-to-open-source/)
- [Using Pull Requests](https://help.github.com/articles/using-pull-requests/)
- [GitHub Help](https://help.github.com)