Forking a repository and re‐committing changes with TortoiseGit - Xyna-Factory/xyna GitHub Wiki

This is a step-by-step guide on how to contribute to one of the repositories by forking, branching and (after implementing your change) committing and pushing using TortoiseGit. The guide uses the zeta repository for demonstration purposes. If you want to use a different repository, you'll have to consider the differing URL / path. Start by creating an Issue explaining what you intend to do.

• Make sure you are logged in into GitHub
• Select the desired repository (in our case https://github.com/Xyna-Factory/xyna-zeta)
• Press the button "fork" on the upper right of the page
• Make sure "only main branch" is selected and click "Create fork"
• Switch to your newly created repository (you'll find it under https://github.com/YOUR_USERNAME/xyna-zeta)
• Press the button "Code" right under the header and copy the url pointing to your repository from the tab "HTTPS"
• Create a folder in your local file system where you'd like to work
• Right-click that folder in your file explorer and select "Git Clone"
• Insert the URL to your Git repository and configure the desired path to your local working directory, then press "OK"
• Switch back to your web browser (with you repository selected) auf click on the dropdown "main" on the left-hand side
• Insert the desired name of your branch in the field "Find or create branch" and click "Create branch"
• Right-click the folder to your repository in your file explorer, select TortoiseGit->Fetch and confirm with "OK"
• Right-click your folder again and select TortoiseGit->Switch/Checkout
• Select your own branch in the "Branch" dropdown and confirm with "OK"
• Implement your changes in your local files
• Right-click your folder and select "Tortoise Commit"
• A dialog will appear where you should review your changes and add a description. If you are satisfied, select the dropdown arrow of the "Commit" button. Select "Commit and push". (The option will instantly be executed.)
• Switch back to the zeta repository in your browser and initiate a pull request. (If you just pushed your changes, a hint for the push including a button "Commit and pull request" will be available on the main page of the repository.)
• Select "Xyna_Reviewers" on the right-hand side of the panel as reviewers, review your changes again, write a comment and press "Create pull request"
• Reference your branch in the issue you created