In this class, we'll be using git for version control and pset submissions. We'll be using the GitHub for managing labs and assignments. You will need a GitHub account to access the code and submit assignments for the class. Do this before the first lab on February 9.

Installing git

If you're using OSX or Linux, git should be preinstalled on your personal machine. If not, follow the instructions to download it here: https://git-scm.com/book/en/v2/Getting-Started-Installing-Git

Git is already installed on the turtlebot laptops.

Setting up on Turtlebots

Each group member will have their own user on their respective turtlebot laptops, to make git usage easier.

Create a user
- Log into the Turtlebot laptop with the existing turtlebot user (password: turtlebot)
- Open Settings >> User Accounts
- Click "Unlock" in the upper right corner of the window and enter the "turtlebot" password
- Click "+" in the lower left corner of the window. Leave the account type as Standard (making it harder to accidentally mess something up system-wide), enter your name and desired username, and click "Add"
- Next to "Password" in the pane for your new user, click "Account disabled" and enter a password for your user.
Connect to Harvard Secure
- On the Turtlebot laptop log out of the turtletbot user and log into your new user account
- Click on the Wifi symbol in the upper right corner and select "Harvard University"
- Go to getonline.harvard.edu and complete the setup for connecting to Harvard Secure
Modify network sharing (this will make debugging future network problems easier)
- Click on the Wifi symbol in the upper right corner and select "Edit Connections..."
- Select "Harvard Secure" and then "Edit"
- Under the "General" tab, deselect "All users may connect to this network" and hit "Save"
Connect to your Turtlebot remotely
- Open a terminal on the turtlebot computer and get the laptop's IP address with: ifconfig
  Under the subheading "wlan0" or "wlan1", look for the "inet addr". This will be an IP address of the form xx.xxx.xxx.xx or similar.
- From your own laptop, log into the turtlebot with your new user:
  ssh -X [YOUR-USERNAME]@xx.xxx.xxx.xx
Setting up your user
- The rest of this setup can be done from your personal laptop, which will let your teammates start getting their users set up
- In your SSH session, enter the following to get ROS working for your user:
  echo "source /opt/ros/indigo/setup.bash" >> ~/.bashrc && source ~/.bashrc
- Follow these instructions to generate an SSH key for your GitHub account.
- Show your SSH key with cat ~/.ssh/id_rsa.pub and copy it to the clipboard (with Ctrl+Shift+C). Follow these instructions (starting from step 2) to add your SSH key to your GitHub account.
- You should now be able to clone, pull, and push to repositories connected to your GitHub account
Set up your git profile
- Run the following from within your terminal:
  git config --global user.email "you@example.com"
  git config --global user.name "Your Name"

Getting and submitting code

For each lab and problem set, the assignment on Canvas will include a link to create your repository for the assignment on GitHub. This may include starter code to get you going.
For the first lab, you will need to create a team with your partner. Use your last names with a space between as the team name (e.g., "Potter Weasley"). You will only need to do this once.
Get a copy of your code locally by running git clone git@github.com:harvard-cs189/[REPO-NAME].git.
You may now use git for your own version control, also! For an overview of basic git usage, see https://git-scm.com/book/en/v2/Git-Basics-Recording-Changes-to-the-Repository or the Intro to Git from Office Hours
There is a "cheat sheet" of relevant git basics for this class available here.

Finding your feet

If you've never used Git before, the experience can be weird and intimidating. There are many great resources on the internet which can help you adjust. The tutorials on https://git-scm.com are great resources! In addition, the TFs are here to help, so please email us if you have questions.