Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

Welcome, Introduction, and Setup

Today:

Not Today:

Introductions

You can see more about me in the about section of the syllabus.

Prismia

questions can be “graded”

This course is structured a bit different than many classes

as an aside another Professor describing what she does not like about learning management systems (LMS). Brightspace is one, she talks about Canvas in the post, but they are similar.

My focus is for you to learn

Learning comes in many forms

Learning is the goal

How does this work?

In class:

  1. Memory/ understanding check

  2. Review/ clarification as needed

  3. New topic demo with follow along, tiny practice

  4. Review, submit questions

and repeat

Outside of class:

  1. Read notes to refresh your memory, check your understanding, and find more details

  2. Complete badges to apply material that has been taught

  3. Prepare for class to activate your memory of related things to what we will cover

  4. Read articles/ watch videos to either fill in gaps or learn more details

  5. Bring questions to class

Getting started

Your KWL chart is where you will start by tracking what you know now/before we start and what you want to learn about each topic. Then you will update it throughout the semester. You will also add material to the repository to produce evidence of your learning.

GitHub Docs are really helpful and have screenshots

they pay people to update them so I direct you to theirs mostly instead of recreating them

Today we did the following:

  1. Accept the assignment to create your repo: KWL Chart

  2. Check your email and accept the invitation

  3. Edit the README to add your name by clicking the pencil icon (editing a file step 2)

  4. adding a descriptive commit message (editing a file step 5)

  5. adding prior knowledge

  6. created a new branch (named kwl-git) (editing a file step 7-8)

  7. added a message to the Pull Request (pull request step 5)

  8. Creating a pull request (pull request step 6)

  9. Clicking Merge Pull Request

Git and GitHub terminology

We also discussed some of the terminology for git. We will also come back to these ideas in greater detail later.

Practice with the vocab, while you read through the syllabus, hover over highlighted words like the ones below:

Terms like this will appear throughout the notes over the course of the semester. They are there to help you study and reinforce what you are learning.

GitHub Actions

GitHub allows us to run scripts within our repos, the feature is called GitHub Actions and the individual items are called workflows.

Navigate to your actions tab

Get Credit for Today’s class

Run your Experience Reflection (inclass) action on your kwl repo

talk with peers to make sure you remember what the right way to click on it is

On the created PR, go to the Files section, edit the file, and commit the changes to the experience-2026-01-22 branch.

Solution to Exercise 1

No, you can continue adding more commits to a PR after by adding them to the branch the PR is comparing.

PRs compare two branches even as one or both of the branches change.

Prepare for Next Class

  1. (for lab Monday) Read the syllabus section of the course website carefully and explore the whole course website

  2. (for lab Monday) Bring questions about the course

  3. (for class Tuesday) Think about one thing that you know really well (computing or not). Be prepared to discuss the following: How do you know that you know it? What was it llike to first learn it? (nothing written to submit, but you can use your issue to take notes if you would like)

  4. Check for comments on your Experience Badge PR and reply to them.

Badges

Review
Practice
  1. Find & Review the notes from today on the course website, include the link in your badge PR

  2. if you have not already joined the course organization, accept this assignment and join the existing team.

  3. Read the notes from today’s class carefully

  4. Fill in the first two columns of your KWL chart (content of the PR; named to match the badge name)

  5. Post an introduction to your classmates on our discussion forum (include link to your comment in PR comment, must accept above to see)

  6. Set a github profile picture (can be of yourself, or anything else, just make it not the default)

Experience Report Evidence

You need to have a KWL repo and be a member of the course organization.

Questions After Today’s Class

How will the other badges be used later on? For example, are there badges for homework and projects?

There will be other types of badges, they are detailed on the grading page. I’ll answer questions about how it works next week.

How is Github used in the real world?

For managing code (e.g. versions, releases, builds, etc) and projects (it has lots of proejct management tools, we will focus on issues, but you can get credit for trying others).

One question I have is how to use the checks tab in github?

If you add automated tests to the repo as github actions, they will show up.

Here is a PR I have open in another project with checks. The checks are defined in action files in the .github folder. In your KWL your .github folder only has actions, not checks, but, writing checks for common activities is a possible explore or build badge project.

Is where in github and how are we submiting assigmemnnts

Yes!

What might I want to brush up on in preparation for this course?

When class sessions will build on specific prior knowledge, your prepare work before class will tell you what to think about. For the very start, if you took any programming classes last semester you should be fine, if not, maybe do a tiny side project (anything with debugging and managing code is good).

What types of projects and work will we complete this semester ?

You’ll have some choices. If you like completeing bigger projects you can do that, if you do not, you can choose to do smaller assignments.

You can look at a past semester[2] to see examples. I reuse some, but change some things too.

How much is GitHub used for data science projects?

GitHub is how lots of people share their data science, plus it is also where most common DS libraries are hosted. For example jupyter, pandas, sklearn, tensorflow, are all hosted open source on github.

Will we be learning how to make a professional profile page?

We will learn directly all of the components to do that and that is an optional project that you could do as a build badge.

When should I use a branch instead of working on main?

Almost always. Especially if collaborating.

Why is git and github used frequently in the computer science world?

Keeping track of versions has been done for a very long time. git is so much better than all of the previous version control systems it’s basically all anyone uses anymore. Even really big legacy code bases that have decades of work in another version control system are movign to git.

git is super fast and distributed. plus some other advantages. We will answer this question throughout the semester as we unpack the details of how git works

If you make another brance separate from your main one, if you want to do a pull request/merge it with the main branch does it take only the information from the last commit?

No, when you merge two branches all of the commits from the compare branch are added to the base branch.

How does the new content show up after you have merged it to the main branch (ie. is it at the bottom, is it at the top, is it in the middle, etc.)

This is a great question and one that you already have the skills to test and figure it out.

Solution to Exercise 2

The content will be in the place you put it on the new branch. The commits will generally be the most recent, but this can vary.

The new content is added to the file and the new version of the file replaces the old one, more or less. If both have changes, then git goes line by line to try to merge the two versions, which is where the name merge comes from.

Footnotes
  1. if you are consistenly gettign questions wrong, because you do not understand and never figure the things out, that will eventually impact your grade. ⚓ If you are reading this in hover text, take a screenshot, then log a community badge with the url for this footnote (get that by clicking after you take your screenshot) and the text footnotehover and include the screen shot in the PR comment.

  2. change spring2026 to e.g. fall2025 or similar.