Skip to content

Latest commit

 

History

History
37 lines (21 loc) · 2.08 KB

CONTRIBUTING.md

File metadata and controls

37 lines (21 loc) · 2.08 KB

Contributing documentation

We'll try to review and merge documentation changes quickly.

If you see something easy to change, you can probably even make the change in your browser!

Contributing code

  1. In your git-tfs clone, run git config core.autocrlf true so that all the line endings are unix line endings when you commit.

  2. Read the source. It's hopefully not that intimidating.

  3. Check for issues. There are a few issues that are low-hanging fruit. Feel free to pick them.

  4. Ask questions. Feel free to drop me a line, or ask a question over at the google group, or join #git-tfs on FreeNode.

  5. Verify that you your editor is configured to use 4 spaces instead of tabs. You could even install the EditorConfig Extension for VisualStudio (such plugin exists for other editors) , and the good space configuration will be set automatically when opening the git-tfs solution.

Pull Requests

Here are some tips on creating a pull request:

  1. Write that awesome code. ✨

  2. Make sure the existing unit tests don't break. We try to keep the unit tests easy to run.

  3. We like new unit tests. If you can unit test your code, do so. One of the pain points of the current git-tfs codebase is that parts of it are very difficult to unit test. It's slowly getting less painful to unit test. One thing to try is to write an integration test that runs git-tfs with the VsFake driver, similar to how the clone tests are written.

  4. If you modify code in any of the client adapters (GitTfs.Vs*), please try it out with as many versions of the TFS client libraries as you can. When you submit the pull request, include a note about which versions you have tried to compile with, and which ones you have tested with.

  5. Include documentation for externally-visible changes.