To-do assignments

On this page
  1. Submission guidelines
    1. Quarto/Markdown
    2. Pull requests
  2. To-do 1
  3. To-do 2
  4. To-do 3
  5. To-do 4
  6. To-do 5
  7. To-do 6

Submission guidelines

Quarto/Markdown

  • If the To-do includes submitting a Quarto document:
    • Render the file to GitHub-flavored Markdown (format: gfm in the YAML header)
      • If errors, fix and try rendering again
    • Make sure the rendered file doesn’t have super-long outputs
      • To see what I mean, create a qmd that just contains as.data.frame(ggplot2::diamonds)
    • Submit both the source .qmd file and the rendered .md file
  • If the To-do includes submitting a Markdown file (whether it’s a rendered Quarto document or a standalone Markdown file):
    • Commit & push the file to your fork to check formatting
      • If formatting looks off, commit & push changes until it looks right (this might mean a lot of commits early on when you’re still learning, and that’s okay!)

Pull requests

  • When creating a pull request, check:
    • Whether GitHub can merge your changes
    • “Changed files”: Anything unexpected?
      • If we’ve done an in-class assignment since your last pull request, then those files will be included in the PR. That’s fine as long as you’ve added your name as a suffix to the file

To-do 1

Due Aug 27 by 12 noon

  1. At the end of the semester, previous students in this class wrote anonymous letters to future Data Science students detailing their advice for how to succeed in the course. These letters are pinned to our Discord #announcements channel here. Please read these letters and identify:
    • One idea that surprised you and why it surprised you
    • Two concrete strategies that you will take in order to succeed in Data Science this semester
  2. This semester, you’ll frequently be asked to identify a muddiest point: some concept, skill, or nagging question that’s giving you the most issues or that you’re most unsure about. This could be something we’ve already gone over, or an extension of what we’ve discussed.
    • Read the assigned readings from our R for data science textbook (the intro and chapter 2).
    • Then identify your muddiest point about the chapters.

    Good muddiest points are specific questions. Using Git as an example:

    • “Why does Git make us stage files before we commit them?”
    • “I keep getting the message no changes added to commit (use "git add" and/or "git commit -a"), what am I doing rong?”
    • “What is .gitignore?”
    • “Do you [Dan] actually use Git in your projects?”

    Not-so-good muddiest points are noun phrases or vague questions:

    • “reverting files”
    • “How do I use Git?”
  3. The next step on our Git journey is GitHub
    • Create a GitHub account at https://github.com/, if you don’t already have one. Pick a good username because changing your GitHub username creates annoying problems.
    • Add your Pitt email address to your account.
    • Check your inbox and spam folder for a verification email.
    • Add an avatar to your GitHub account (usually a headshot, but can be anything you like).
    • In your submission, send me the link to your GitHub user page (i.e., https://github.com/YOUR-USERNAME). You don’t have to add any other personalization, just send me the link.

Submission

Write up your answers in a text file (should have the .txt extension) or a Markdown file (.md) if you’re comfortable with Markdown. Name the file todo1_YOURNAME.txt or todo1_YOURNAME.md (replace YOURNAME with your actual name). Share it to the #to-dos channel on our Discord server.

To-do 2

Due Sep 1 by 12 noon

Time for some hands-on practice! Do the following:

Git

  1. Think about what Git can do, and think back to the ways you’ve managed files in the past. Even if you didn’t realize it, you had a set of file-management practices. Describe your existing file-management practices. What are some benefits and drawbacks? How could Git help you improve your existing file-management practices?

    Example answer
    When I’m writing a paper, I’ll add a versionX suffix like version0.5, version0.6, etc. Once I feel like I’ve made decent progress, I’ll increment the version number and add a little comment to the top of the file describing the changes since the previous version. Then I don’t touch the old file, and I only work on the latest version. Each new version is basically like a Git commit, and the little comment is like a commit message. In my current system, the little comments aren’t easy to glance over; if I’m looking to undo a previous change, I have to re-open each old version to read through the commits. Git can do that more easily by letting me see commits and diffs at a glance. Plus, in my current system there’s no guarantee that I won’t accidentally change an old version rather than the latest version, which would render the “commit message” useless. Git prevents that from happening because once changes are committed, they’re there.

    Write up your response as git_notes_YOURNAME.txt (or .md)

GitHub setup

  1. If you haven’t set a personal access token for GitHub, do so now:
    1. In the R console, run usethis::create_github_token()
    2. This will load a GitHub page for you to generate a PAT
      • In “Note”, write “My laptop” or something that describes your local machine
      • In “Expiration” set “No expiration” (even though GitHub doesn’t recommend it)
      • Leave everything else as-is
      • Click “Generate token” and copy your token to the clipboard
    3. Back in RStudio, run gitcreds::gitcreds_set() without any arguments
    4. Follow the prompts and paste your token when asked
    5. Change your Git config user name to match your GitHub user name: usethis::use_git_config(user.name = "YOUR GITHUB USERNAME")
  2. Let’s get you set up with the Class GitHub organization.
    1. Accept the invitation: You should have gotten an invitation email from GitHub (subject line something like “[GitHub] @djvill has invited you to join the @Data-Sci-2026 organization”); click in the link in that email. Or go to https://github.com/orgs/Data-Sci-2026/invitation and click the green “Join Data-Sci-2026” button.
    2. Set your visibility to Public: Go to https://github.com/orgs/Data-Sci-2026/people, click “🔒 Private” by your name, and click “Public”.
      • This just ensures that anyone can see that you’re in the GitHub organization. It doesn’t mean that anyone can see all your activity in the organization (specifically, in private repositories).

ggplot2 and chapter notes

  1. Learn about ggplot2! Go through the Data visualization and Workflow: scripts and projects chapters in our class version of R for data science. (Pay attention to the yellow blocks, where I’ve injected notes for our class into the chapter!)

    It’s up to you how thoroughly you want to interact with these materials. You could just read them, or you could just copy and paste the code. But for coding, the most effective way to learn is by doing—not just typing out all the commands yourself and ensuring you get the same output, but tinkering and exploring.

  2. Future to-dos will ask you to create your own study notes for R4DS chapters. For now, your task is to evaluate some past students’ ggplot2 notes, which you can find at https://github.com/Data-Sci-2026/Class-Exercise-Repo/tree/main/todo2/old-notes. Read over these notes on GitHub (that is, in your browser, not downloaded to your computer). Compare and contrast: If you were future-you, how helpful would you find these notes? Are there some notes you’d find more helpful than others? Pay attention not only to content but also style, formatting, and organization. There’s not a right or wrong answer here—different things work for different people! Write up your observations in notes-on-notes_YOURNAME.txt (or .md).

    These notes were for the previous edition of R4DS (https://r4ds.had.co.nz/data-visualisation.html), hence any differences in section numbers, etc.

Submission

Share your notes on the #to-dos channel on Discord.

To-do 3

Due Sep 3 by 12 noon

  1. Now that you’ve reviewed past students’ study notes, it’s your turn! Read up on Quarto, a literate programming framework for data science, in the Quarto chapter of R for data science. Create some notes that’ll be helpful for future-you in a Quarto document called quarto_notes_YOURNAME.qmd.

  2. What’s your muddiest point for ggplot2? Create a file called ggplot2_muddiest_YOURNAME.txt that has your muddiest point: After going through the Data visualization chapter, what’s the concept or skill that’s giving you the most issues? What are you most unsure about?

  3. Attempt to pull Class-Exercise-Repo from upstream. This will add a new directory to your local repo: todo3/. If you get an error message, ask me about it in Discord #q-and-a

Submission

From here on out, to-do submissions will take the form of GitHub pull requests. You should have 2 new files: Quarto notes and ggplot2 muddiest point. Add your files to todo3/, stage, commit, and push to origin. Start a pull request, and remember the “PR checklist”: check whether GitHub can merge your changes, and check the changed files. (See the new “Submission guidelines” section above.) If it looks good, open the pull request.

To-do 4

Due Sep 8 by 12 noon

It’s time to flex our newfound skills with Markdown and Quarto!

  1. Learn about dplyr! through the Data transformation chapter in our class version of R for data science, and create your own study notes as todo4/dplyr_notes_YOURNAME.qmd. Then render to a GitHub-flavored Markdown file todo4/dplyr_notes_YOURNAME.md.

    A string like “todo4/dplyr_notes_YOURNAME.qmd” is a shorthand way of referring to a path: both the file (dplyr_notes_YOURNAME.qmd) and the directory that it sits in (todo4/). You’ll sometimes see paths with a file multiple directories deep (e.g., ~/Documents/Research/research-plan.md). You should not include todo4/ in the file name.

  2. Create a muddiest point for dplyr as todo4/dplyr_muddiest_YOURNAME.md.
    • Note: Just a regular Markdown document, not a Quarto .qmd.
  3. Commit and push your changes to your fork (git push in the RStudio Terminal, not the “Push” button), but don’t create a PR yet! Visit your fork on GitHub and inspect the Markdown files, just for formatting: Do they look like you expect (e.g., are there any stray formatting marks, does the R output look right, etc.)? Write a few notes about what seems to be working or not working, including a muddiest point, as todo4/markdown_notes_YOURNAME.md; commit and push to your fork.

Submission

You should have 4 new files in the todo4/ directory on your fork:

  • dplyr_notes_YOURNAME.qmd
  • dplyr_notes_YOURNAME.md (rendered from the .qmd)
  • dplyr_muddiest_YOURNAME.md
  • markdown_notes_YOURNAME.md

(Note the file extensions.)

Create a pull request for me. As always, ask questions if you run into any difficulties!

To-do 5

Due Sep 10 by 12 noon

  1. Reflect on your experience trying to remember dplyr functions in our last class meeting. How effectively were you able to use your dplyr notes during class? If you didn’t find your notes useful, what would have made them more useful as a resource? Write up a short paragraph in notes-on-notes_YOURNAME.md.

  2. Learn about tidy data and pivoting in the Data tidying chapter! Create tidy-data_notes_YOURNAME.qmd, rendering it to gfm.

  3. Create a muddiest point: tidy-data_muddiest_YOURNAME.md

Submission

The usual, in the todo5/ directory of the Class-Exercise-Repo.

To-do 6

Due Sep 15 by 12 noon

  1. Let’s follow up on tidy data. In the todo6/ directory of the Class-Exercise-Repo, there’s a tidy-gradebook.qmd. Create a copy (tidy-gradebook_YOURNAME.qmd) and answer the questions to the best of your ability. Render to tidy-gradebook_YOURNAME.md.

  2. The next step on our data-wrangling journey is when data is spread across multiple tibbles: relational data (in the Joins chapter)! You know the drill by now: Create relational-data_notes_YOURNAME.qmd, rendered to gfm; plus a muddiest point as relational-data_muddiest_YOURNAME.md.

  3. Your final projects will be published as public repositories, just like previous versions of this class. (I’ll release more info about the project next week.) Choose three projects from the list on the todo6 README.md to review. Read their project_plan.md, progress_report.md, and final_report.md, then create a one-paragraph summary (for each) of how the project evolved. Write up your observations in the file proj-observations_YOURNAME.md.

Submission

The usual, in the todo6/ directory of the Class-Exercise-Repo.