---
# System prepended metadata

title: Assignment Guide
tags: [ACIT-1515]

---

<style>
    .markdown-body h1:first-of-type {
        margin-top: 24px;
    }
    .markdown-body h1 {
        margin-top: 64px;
    }
    .markdown-body h1 + h2 {
        margin-top: 32px;
    }
    .markdown-body h2 {
        margin-top: 48px;
    }
    .markdown-body h2.topics {
        font-size: 1.8em;
        border-bottom: none;
    }
    .markdown-body h2 {
        color: #5a57b8;
    }
    .markdown-body h3 {
        color: cornflowerblue;
    }
    .markdown-body h4 {
        color: cornflowerblue;
    }
    .exercise {
        font-size: 150%;
        font-weight: bold;
        color: rgb(227,112,183);
    }
    .note {
        color: red;
    }
    .markdown-body em {
        color: #e000e0;
    }
    .markdown-body strong {
        color: #e000e0;
        font-weight: bold;
    }
    .markdown-body p a,
    .markdown-body td a {
        border-bottom: 1px solid;
    }
    .markdown-body a:hover {
        border-bottom: none;
        text-decoration: none;
    }
</style>

# Assignment Guide

For each of the assignments in this course (10 total over the semester), you will be required to download starter code from Github and install any necessary Python libraries.

To set up your environment so that you can easily download and configure all the assignments throughout the semester, begin by [creating a folder](#creating-a-folder-to-store-all-your-acit1515-assignments) somewhere on your Ubuntu WSL instance.

## Creating A Folder To Store Your ACIT 1515 Assignments

Begin by opening the Terminal application, connecting to your WSL instance, and navigating to your home folder. *Note*: the tilde symbol '~' is a **shortcut** for `/home/YOUR-USER-NAME`!

```shell
wsl ~
```

Once inside your WSL instance (if you see a path in your terminal that begins with `/mnt/c` you are still in your Windows filesystem - switch to the Ubuntu filesystem using `cd ~`) create a folder inside your home folder using:

```shell
mkdir ~/Documents
```

Next, create a folder inside the Documents folder using the following command:

```shell
mkdir ~/Documents/1515
```

and navigate into the folder you just created using:

```shell
cd ~/Documents/1515
```

## Getting Assignment Starter Code

Each week you will get an invite link to a Github assignment repository. Once you have clicked the link and accepted the assignment, Github should display the url of your individual repository, e.g.: `https://github.com/CIT-BCIT/a1-michaelkwilliams`

**NOTE: the url noted above uses https (requiring login using username and password), but you will likely want to use password-less authentication via ssh to download your starter code. This can be accomplished by first setting up your SSH key (see the guide on the Learning Hub under Content > Week 1) and modifying the url so that it begins with `git@github.com:` followed by the rest of your url. See the code below for examples**

Once you have this link, ensure you are in your 1515 folder:

```shell
cd ~/Documents/1515
```

then 'clone' (download) the repository (substituting your actual username and link):

```shell
git clone git@github.com:CIT-BCIT/a1-michaelkwilliams assignment1
```

Note that the second argument in the previous command, 'assignment1' is the *name* of the folder that will be created, which will contain all the files from the repository. Change this as necessary for future assignments.

Class time will be given to help you troubleshoot - if you encounter any difficulties please DM me through our Discord server.