<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`!

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:

mkdir ~/Documents

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

mkdir ~/Documents/1515

and navigate into the folder you just created using:

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 `[e-mail]:` 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:

cd ~/Documents/1515

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

git clone [e-mail]: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.