Gerrit/TortoiseGit tutorial

This tutorial may help windows users contributing the source codes to gerrit and git.

Install software
On the other hand stating that GUI does a quick compression cleanup of the local repository if needed.
 * 1) Download and Install TortoiseGit
 * 2) Download and install [//msysgit.github.io/ Git for Windows]
 * 3) Select Windows Explorer integration – Simple context menues entries: "Git Bash here" which is recommended.
 * 4) * It is optional to select Additional Icons for Desktop and Quick Launch
 * 5) * It is optional to select Git GUI here but we use TortoiseGit as Graphical User Interface.
 * 1) * Do not select Advances context menu (git-cheetah plugin)
 * 2) * You should keep the file associations for *.git and *.sh
 * 3) * It is up to you to use TrueType fonts in all console windows
 * 4) Keep the default Start Menu Folder
 * 5) In next step we choose "Run Git from Windows Command Prompt". Otherwise some scripts may not run.
 * 6) Select 1st item Checkout Windows-style, commit Unix-style line endings for the line ending conversions

Create and publish your SSH-Key

 * Start puttygen.exe in the quick launch menu or in folder, create an new SSH key and save the private key it in a .ppk file; also save the public key.
 * Login to https://gerrit.wikimedia.org, use your labs username and password
 * Go to Settings > SSH Public Keys and add your public key
 * Go to Settings > Identities and verify your email address and account (identity)

Clone your working copy

 * Right.click on windows explorer ans select "Git clone" to clone a repository to the given directory. Use the URL from gerrit repository e.g.  for the pywikibot core.
 * Select the recursive switch.
 * Be aware: port 29418 is required for ssh access here. The default ssh port 22 does not work! Adjust your router or firewall if required.
 * You may choose "Load Putty Key" and select your private .ppk file given above. Or you may deselect that button and setting up in the next step.

Setting up TortoiseGit

 * Right-click on your repository and open TortoiseGit > Settings
 * Choose Git > Remote and select "origin" remote server. Verify the URL and select your private Putty Key .ppk file if not done previously.
 * Choose Git (or Git > Config) and verify whether your Name and Email of the User Info is the same as your gerrit account.
 * Click on Edit global .gitconfig and again verify your name and email to be these same as in gerrit.
 * Choose General > Set Extend Menu Item and deselect Browse References

Git Settings

 * Right-click on your repository and start Git Bash
 * Type the following lines:

Install commit-msg hook

 * Download the commit-msg hook script from the repo and install it into the   folder using.
 * Note:  is a hidden folder.
 * See also Gerrit/Alternatives to git-review for other variants to install the script.

Missing Change-Id in commit message
Install commit-msg hook first, see above.

Git Clone hangs
If Git Clone... hangs after "Resolving deltas" hits 100% and you are using PuTTY: Open up PuTTY, load Default Settings, and set "Chokes on PuTTY's SSH-2 'winadj' requests" to "On" under Connection->SSH->Bugs. Then select Session, select Default Settings, and Save.

See also:

 * TYPO3 Contribution Walkthrough with TortoiseGit