Do something tedious

A messy folder, on your own machine. The job a chat window can’t do.

The folder

An exam export, the way it comes out of WISEflow:

  • 15 group submissions, each in a folder named like [3-2048892] - Group 1.
  • Inside: a cover sheet, and an “Appendix material” folder with files called EKSAMEN.pdf, final.pbix, dashboard_v3_FINAL.pbix…
  • An empty grade sheet, in a different order from everything else.

Synthetic, so safe. You’d normally spend half an hour clicking through it.

Get it, and save a point

  1. In your practice folder, paste the download prompt from the handout, section 2. It fetches decrap-me.zip and unzips it.
  2. Then, before it changes anything:

Set up git here and commit everything.

First time? “Set up git with my name, …, and my email, …”

Now it can’t do anything you can’t undo.

Clean it up

  1. “What’s in decrap-me? What would annoy a teacher about it? Don’t change anything.”
  2. “Reorganise it so I can grade quickly: one folder per group, files named by group and what they are, and the grade sheet sorted by group. Show me the plan first.”
  3. Argue with the plan. Change at least one thing. You’re the boss.
  4. “Go ahead.”
  5. “Make a grading table: group, participant ID, report file, dashboard file, and an empty column for the mark.”

What changed, and the undo

  • “What changed since the last commit?” Every move and rename, listed.
  • “Commit.”
  • Now be bold: “Delete the Marking guidance folder.” Gone?
  • “Go back to the last commit.” It’s back.

Save point first, then courage.

What git is

Downloaded the export commit · 10:12 Reorganised by group commit · 10:25 Added grading table commit · 10:31 Deleted a folder not saved yet go back
  • Every commit is a snapshot of the whole folder, with a message.
  • It lives in the folder (a hidden .git folder). Nothing leaves your laptop unless you push it.
  • You don’t learn commands. You ask.

What it’s for

  • Nerve. Let the agent try something bold. Hate it? Go back.
  • Seeing before accepting. “What changed?” shows every moved file and every edited line.
  • A history you can ask about. “When did the sample drop from 240 to 220, and why?”
  • Trying two versions side by side, without analysis_v2_FINAL.R.
  • Sharing. The same history on GitHub, for co-authors and backup.

Branches and GitHub

YOUR LAPTOP a branch: try something, merge it back GitHubthe same history, onlinepushpull
  • A branch is a parallel version: try something, then keep it (merge) or drop it.
  • Push sends your history to GitHub. Pull fetches your co-author’s.

Six words worth knowing

Word Means You say
commit a save point, with a message “Commit this.”
diff what changed since a save point “What changed?”
log the list of save points “Show me the history.”
restore go back, for one file or all “Go back to the last commit.”
branch a parallel version, to try something “Make a branch to try X.”
push / pull send to / fetch from GitHub “Push.” · “Pull.”

Commit before you let it loose, and again when it works.