For starting the project, first, you need to create your team's repository. Follow the invite link in the document, select your student number and create/join your team. After creating a team, a private repository will be created for you. You should use this repository to collaborate with your teammates and submit your codes. The repository is created empty. You should clone this repository and push it on that. Please note that handouts may have minor issues and get updates during a phase. They also will be updated on each phase to contain the material needed for that phase. To stay updated with it, we recommend setting multiple remotes on your local clones.
Git knowledge is essential whenever you write even a single line of code. The more you learn, you will notice how helpful it is. If you are not familiar with git yet, it is strongly recommended to take this tutorial.
Right after creating your team and your private repo, you will need to push this material into that empty repo (only one of the team members should do this once). First, clone the handouts repository on your computer (via ssh or over https).
# If you prefer https clones, just replace 'git@' with 'https://' at the start of the links.
$ git clone [email protected]:ce323/mips-handouts.git
$ mv mips-handouts project-<team-name>
$ cd project-<team-name>
Now the handouts repository will be named origin
in your repository remotes. We need to change its name to handouts
and add your private repository as origin
.
$ git remote rename origin handouts
$ git remote add origin [email protected]:ce323/project-<team-name>.git
Then, you can initiate your team's private repository by simply pushing into that.
$ git push origin master
Your repository is ready and you can start developing your processor. From now on, you can treat your repository as a single remote one and do whatever you did before. And for getting handouts updates, you can simply run:
$ git pull handouts master
But wait, what should we do to clone and set up our repo after we created it? (this includes other members, or even the first member trying to clone again) If you pushed into your repository once, then you just need to clone it and add handouts as a remote.
$ git clone [email protected]:ce323/project-<team-name>.git
$ cd project-<team-name>
$ git remote add handouts [email protected]:ce323/mips-handouts.git
Your repo is ready. Enjoy implementing the project :)
If you noticed any issue in the handouts, please feel free to open an issue on the handouts repository.