🧩 1.0 Orientation#

Note

After registering, access instructions for https://q.utoronto.ca will usually be emailed to you within 24 hours. While you’re waiting, you can still get started with the orientation content below and the first tutorial.

Note

If you haven’t already, watch the welcome video below to learn about the course and its structure.

🔰 Getting Started#

The list below shows your course section based on the day you registered.

  • W 2024: Registered between Jan 1, 2024 to April 30, 2024

  • Sp/Su 2024: Registered between May 1, 2024 to April 30, 2025

  • Sp/Su 2025: Registered between May 1, 2025 to April 30, 2026

  • Sp/Su 2026: Registered between May 1, 2026 to April 30, 2027

Tip

For registered students, if you click on a link to a quiz or assignment and it shows “access denied” after logging in, try the other tabbed links.

First, open up the following quiz in Canvas that corresponds to your enrolled term.

You will record your GitHub username and GitHub Classroom Student Identifier (obtained after accepting the GitHub Starter Tutorial below), which will be used later in the course. You can refer back to these quiz answers if you forget. See below for information on these two.

GitHub Account#

These courses are integrated with coding exercises via GitHub Classroom, so you will need to create a GitHub account if you don’t already have one. Take note of your GitHub username since you will enter this as a quiz response.

Tip

Two typical naming conventions for GitHub usernames are as follows:

  • John H. Smith → jhsmith

  • Jane M. Doe → jane-doe

If you already have a GitHub account and you have used it infrequently, you may consider renaming your GitHub account to adhere to one of the conventions above. This is completely optional.

GitHub Starter Tutorial#

Warning

The student identifier that you choose on the next page will appear only once (e.g., quirky-zebra). Please record this somewhere safe and enter it into the corresponding Canvas quiz, since you will be using this at various points throughout the course. If you forget or lose your student identifier, please send a message to sterling.baird@utoronto.ca.

Click on the 🔗 GitHub starter tutorial, ensure you’re logged in to GitHub, link to a student identifier of your choice (write this down), and accept the assignment. See below for a walkthrough of this.

Use this tutorial to familiarize yourself with git and GitHub terminology, which you will be quizzed on later.

GitHub Classroom Assignment#

Now that you’re familiar with basic git and GitHub terminology, we can show you how to use GitHub Classroom for an autograded assignment.

👉 Second step: This time, you will use an interactive development environment (IDE) called “Codespaces”, with compute resources provided by the Acceleration Consortium through the GitHub Education program. Similar to the format before, click on the new assignment link 🔗 Intro to GitHub Classroom, ensure you’re logged in to GitHub, accept the assignment, click the “Open in Codespaces” button, and follow the directions in the README.md file.

Spinning up a new Codespace may take a minute or two, and a preview of the README.md file will automatically open up after a few seconds. A number of dialogue boxes and messages will appear during the loading process. Ensure that you sign into GitHub; use of Copilot is optional. The URL in your browser should be of the form https://<some-funny-phrase>-<unique-id>.github.dev/ which is autogenerated and distinct from your course ID. For example, your URL might be https://fuzzy-space-spork-9wggxx444g6h7rxq.github.dev/. See below for a complete walkthrough of these steps.

Tip

When you accept an assignment, it creates a GitHub repository for you. The ability to use Codespaces is meant as a convenience for you and a way to ensure consistent environments; however, the repository can be cloned to your computer (e.g., via GitHub Desktop) and opened in an IDE of your choice (e.g., VS Code, PyCharm). Likewise, you can carry out version control in your preferred way (e.g., VS Code, GitHub Desktop, command line).

You will self-report your autograded score using the assignment link below, and you can try the assignment as many times as you like.

Tip

An easy way to navigate back to your assignment is to click the GitHub Classroom assignment link again (available on the Quercus assignment page specific to your enrolled section). Here, you will see the Open in Codespaces button and a link to your GitHub repo assignment. Alternatively, you can navigate to your ACC-HelloWorld GitHub organization repositories to see a list of assignments.

Additional resources:

Tip

If you’re eligible, consider signing up for the student developer pack so that you can have free access to GitHub Copilot (and GitHub Copilot Chat), among other perks. GitHub Copilot is also free for teachers.

If you’re not eligible, you may consider a paid subscription (~$10 USD/month). It’s kind of like having a personal coding assistant to bounce ideas off of and have it look at your code. At the same time, it can become a crutch, and there are still times where plain-old Google searches, reading stack overflow posts, and searching through a GitHub repository’s issues and documentation is better. The Acceleration Consortium does not benefit from you signing up for GitHub Copilot, and it is not required for the completion of this course.

Python Refresher Assignment#

Optionally, you may try out the Python refresher assignment. This is ungraded.

Syllabus#

For registered learners, take a moment to review the course logistics and policies in the syllabus. Here, you will also find a link to the Learner Equity Survey, an anonymous and voluntary demographic survey.