Редактирование: Setting up git (раздел)

== Initial Setup ==

'''Step 1:'''
The first step you need to perform is to install and download Git, located [https://git-scm.com/downloads HERE]. Git, or Gitbash, is a commandline style setup for making a working github repo off of a base sourcecode, but has some distinct advantages over many of the alternatives (Github desktop, Tortoise Git, Gitkraken, etc). In particular, it lacks many of the frills that a GUI based git client would give you, but it also gives you more exact control over what you're trying to do, and because of that if you make a mistake you can work backwards to fix something that might have gone wrong.

'''Step 2:'''
Next, you need to create a fork of the base code. Go to the tgstation repository on github, and on most any page of the repo you'll want to hit the ''fork'' button at the top right.
This may take a moment, but what this effectively does is it creates a copy of the code that belongs to you, but is linked directly to the main repository. This means that when a new Pull Request (PR for short) is merged into the main codebase, and is added to the game on live servers, you have a link through the website to easily make the new changes on your local version of the code.

'''Step 3:'''
Get your Fork URL from github. It should be something like '''https://github.com/'''''<yourgithubusername>'''''/tgstation.git'''. You can also find this by hitting the large green '''Clone''' button on your fork. This URL is what effectively will link your github fork on the website to the code that you're about to download, so keep it on a tab or somewhere where you can pull it up in a moment.

'''Step 4:'''
Navagate in your window explorer or file browser where you want your github repo to exist on your computer. Then, right clicking from within that file, open your command line. You may also do this with "Git Bash Here" on your right click menu, if you enabled that when installing Git.

'''Step 5:'''
From your command line prompt, enter '''''git clone <yourforkurlfromstep3.>'''''. This tells git to take the code from that public github fork, and paste it into your designated folder.

'''Step 6:'''
Next, run '''git init.''' This initializes your workspace. Now your workspace exists, congratulations!

'''Step 7:'''
Now, run '''git remote add origin <''yourforkurlfromstep3.''>''' This is going to create a source for you to pull your code from called '''''origin'''''.

'''Step 8:'''
Next, also in command line, enter: '''''cd tgstation.''''' It doesn't have to be tgstation, but whatever your file holding the tgstation repo code should be what you run, even '''cd dinglesparce''' if your file was named dinglesparce, you wildcard you.

'''Step 9:'''
Then, finally, enter: '''''git remote add upstream https://github.com/tgstation/tgstation.git'''''. This will make sure that the tgstation main repo is assigned to a remote branch, similar to your origin branch, called '''''upstream'''''. 

This should cover everything you need to get started, but now lets talk about actually USING git for something practical.

{{Important
|Title=Author's note
|Image=Warningsign.png
|Note=
Now that your git is set up, you may want to also download [https://code.visualstudio.com/ Visual Studio Code], as there are plugins and add-ons that make working with byond code and the rest of the codebase significantly easier, but you can avoid that for now if you just want to get familiar with gitbash and the codebase (But #coderbus will ask you to download it at some point anyway).
|Color=#00F
}}