The Missing Semester of Your CS Education – Revised for 2026

2/24/2026 at 1:46:13 PM

I'm glad to see there is a "Beyond the Code" section that discusses comments. Here's what I typically told my students in Intro to Programming" Good comments lend insight into the code. Reading the code itself tells you the what. Comments should explain the why. Comments like "i+=1; /* Increment i */" are of little value. However comments such as "We increment i mid loop so that we can peek ahead at the next value for a possible swap" are more useful. Use a narrative voice when writing comments, like you are explaining the code to your grandparent. This make digestion easier. Remember, code spends most of its life, and most of its expense, in the maintenance phase. The easier you make your code to understand, the less it will cost and the longer it will live.

by NoNameHaveI

2/24/2026 at 7:40:18 PM

I prefer comments like "I'm sorry about this, I know it's ugly but I'm in a rush and it's the quickest way to get it working"

by dec0dedab0de

2/25/2026 at 6:08:28 PM

Would your Grandma approve of you introducing that technical debt?

That’s why it’s important to write comments as if to your grandparents. For the feelings of accountability that it engenders.

by jimbokun

2/24/2026 at 9:22:10 PM

As long as there's a "TODO" tag in the comment to easily search for, then I prefer those comments as well.

by stronglikedan

2/25/2026 at 12:39:02 AM

I prefer all "TODO" comments to be well-defined and have a specific ticket number attached to them to ensure they are tracked.

I don't see any harm to the occasional "I'm sorry" or humorous comment

by culi

2/25/2026 at 2:11:11 AM

My first team figured that out after a year or so. If it’s really TODO, it should either be addressed before the WIP feature is considered “completed”, or it needs to show up in our work tracking system. Otherwise it just fell through the cracks and would never be prioritized.

by e28eta

2/25/2026 at 1:32:12 AM

The number of people I know who honor TODOs is pretty slim, but I find it does in fact help if you get people to stick their initials next to it. Over enough refactors a TODO can lose its meaning and author.

TODO (DKH) - This should handle negative numbers

can be helpful later if there's nothing in the requirements about negative numbers. Why do we need to handle negative numbers? Is it for some mystery feature? Performance? Security? What? Why?

'DKH' might recall what they were thinking if you prompt them.

We see what we want to see, and a TODO when we are in a hurry probably won't trigger much guilt or associated motivation to do something about it. Or at least, not as much as if we see our own initials in the TODO.

(Also handy when prepping a commit, since you might have left breadcrumbs in case you get interrupted, and then forget one or two of the tasks you still had outstanding afterward)

by hinkley

2/24/2026 at 11:37:44 AM

Great to see a chapter on version control. It is such a shame that almost no CS program teaches proper version control. VCSs and the commit history can be such a tremendously valuable tool when used correctly.

git bisect/blame/revert/rebase/… become so much less useful when VC is treated as a chore and afterthought, and basically amounts to: “Feature is done, my work is complete, just do `git commit -am "changes"` and be done with it.”. And don’t get me started on commit messages.

It is shameful that for a large part of the industry, this is the norm. It is shameful that for a lot of professional, who call themselves software architects or reliability engineers and such fancy titles, still have essentially no idea what they are doing with git, and their response when git add/commit/push/pull don’t work is to shrug, and just delete and re-clone the repo.

Version control should be treated with care and attention to detail. It pays for itself 100 times over.

If your commit history is maintained and tells a story, it is a joy to review your PR. If you just `git commit -am "try fix"` 26 times over, and all that is left in the end is a ball of mud, it is horrible.

by Hendrikto

2/24/2026 at 1:57:06 PM

If most people are not using a tool properly, it is not their fault; it is the tool's fault.

Git is better than what came before, and it might be the best at what it does, but that does not mean that it is good.

- The interface is unintuitive.

- Jargon is everywhere.

- Feature discoverability is bad.

- Once something goes wrong, it is often more difficult to recover. If you're not familiar enough with Git to get yourself into that situation, then you certainly aren't familiar enough to get yourself out of it.

Many of those issues are due to git being a command line interface, but others (like no general undo and funny names) are simply due to bad design.

I think it is about time that we try again and build a better version control tool, but maybe git is just too entrenched.

by xml

2/24/2026 at 2:58:57 PM

> If most people are not using a tool properly, it is not their fault; it is the tool's fault.

I would say that is a reasonable criticism of git ... but I've seen the same thing in svn, perforce, cvs, and rcs. Different variations of the same issue of people not caring about the version history.

Since it's been a problem since the dawn of version control, it is either something that is part of all version control being a tool's fault that has been carried with it since doing ci, or it is something that people aren't caring about.

I feel this is more akin to a lack of comments in code and poor style choices and blaming the text editor for not making it easier to comment code.

by shagie

2/24/2026 at 6:33:39 PM

> problem since the dawn of version control ... a tool's fault ... or it is something that people aren't caring about.

At the start of my career I ended up in a UI position. Old school usability on the back side of a 2 way mirror.

The tool has lots of shortcomings: images, documents that aren't text, working with parts of repositories... These aren't issues faced by the kernel (where emailing patches is the order of the day). And these shortcomings have lead to other tools emerging and being popular, like artifactory, journaling file systems, and various DAM's.

Technology on the whole keeps stacking turtles rather than going back to first principles and fixing core issues. Auth (DAP, LDAP, and every modern auth solution). Security (so many layers, tied back to auth). Containers and virtualization (as a means of installing software...). Versioning is just one among this number. We keep stacking turtles in the hope that another layer of abstraction will solve the problem, but we're just hiding it.

One of the few places where we (as an industry) have gone back and "ripped off the bandaid" is Systemd... It's a vast improvement but I would not call it user friendly.

Usability remains a red headed step child, its the last bastion of "wont fix: works for me" being an acceptable answer.

by zer00eyz

2/24/2026 at 2:29:41 PM

> If most people are not using a tool properly, it is not their fault; it is the tool's fault.

This is a standard that we don't apply to most other tools outside of IT. I do think git could be more usable, but most powerful tools have sharp edges and require training.

A bandsaw is a fantastic tool, but if you try to use one without reading about it first, you'll end up losing a finger. I'm not sure I'd blame the bandsaw in that instance...

by cameronh90

2/24/2026 at 4:57:39 PM

Contemporary bandsaws used by people who take workplace safety seriously have emergency brakes for just that reason (countless trained operators also lost fingers). Improving tools is something we've been doing since our ancestors first held a branch. If we satisfied ourselves with good enough we'd live much different lives.

by dpc050505

2/24/2026 at 2:45:49 PM

To put it into your metaphor: I am not advocating against the existence of bandsaws. I would just rather have bandsaws that do not cut off your fingers if you do not read a book about them first and make it difficult to sew the fingers back on, while requiring arcane incantations to do their work.

There are of course power tools with obnoxious protections that make them difficult to use, but since we are dealing with software here, we are not bound by the laws of physics. I believe that we can create a better tool that is both powerful and easy to use.

by xml

2/24/2026 at 6:24:12 PM

We did! Mercurial!

by irishcoffee

2/24/2026 at 2:37:16 PM

Then again, the number of shop teachers missing a finger would give anybody pause. Blame is secondary to the fact that you just lost your fucking finger. Thankfully, git's sharp edges won't permanently physically maim you, though guts sharp edges resulting in you committing API keys GitHub can still hurt you, just in your wallet but at least you didn't lose a finger.

by fragmede

2/24/2026 at 3:59:02 PM

Contrast with:

https://old.reddit.com/r/todayilearned/comments/158lp0m/comm...

>My high school shop teacher, before he let any of us near the machines or power tools, told us horror stories about students who lost fingers and eyes by being careless with them. For the entirety of that semester, nobody got so much as a chipped fingernail.

which is a better match for my experience --- the best advice I ever got was from my high school shop teacher:

>Before turning on the power switch, count to ten under your breath on all your fingers while visualizing all the forces involved and all the ways the operation could go wrong, then remind yourself that you want to be able to repeat that count after turning the power off.

I don't think Sawstop would have a business model if all tablesaw injuries were tried by a jury of such shop teachers (heard him scream at the kid who removed a guard through hearing protection all the way on the other side of the shop around a corner while operating a lathe while making a heavy interrupted roughing cut w/ a chisel I really should have paused to sharpen --- the student was banned from ever entering the shop again).

by WillAdams

2/24/2026 at 3:35:34 PM

> If most people are not using a tool properly, it is not their fault; it is the tool's fault.

Replace tool with one of piano|guitar|etc and see your logic fall apart. Software tools like any other have a manual and require effort and time to learn.

by netdevphoenix

2/24/2026 at 3:50:06 PM

modern instruments are actually improved designs of older instruments which were just that: badly-designed & hard to use

by Throaway1982

2/24/2026 at 4:14:53 PM

Modern instruments are still difficult to use unless you spend time learning how to. Just like git.

by tovej

2/24/2026 at 4:19:20 PM

No they're easy to use. They're hard to master. Git is hard to figure out how to even upload to.

by Throaway1982

2/24/2026 at 9:43:29 PM

I see the point and I wouldn't want to belabor the metaphor, but I really feel like guitar is actually extremely difficult to even get started with. Between the awkward stretching of the fingers, how difficult/painful it is to hold down strings hard enough (and close enough to the fret) to get a clean, clear note, and how hard it is to hold those strings down in such a way that your fingers don't brush against other strings, I'd say guitar is crazy hard to start. I'm saying this as someone who has been playing and enjoying guitar for decades. Beginners have a rough time of it for awhile.

by gglitch

2/24/2026 at 10:56:59 PM

Depends on the instrument. Anyone without experience or instruction is gonna make a fool of themselves picking up a wind instrument. You need to train the muscles in your face and mouth to form the correct embouchure needed to produce a clear note.

by mcmcmc

2/24/2026 at 9:13:34 PM

Git is much easier to master than the piano. I played piano for years and can only just play two-handed melodies if they aren't well-aligned.

I've read a few blog posts and half a book on git, and I don't remember the last time I had issues with it.

I also don't recall a junior ever having trouble uploading files with git. Unless they're in an interactive rebase, which wouldn't happen your first time trying out git.

by tovej

2/24/2026 at 11:35:42 PM

There’s inherent beauty in mastering the piano. It’s worth it to spend time practicing.

Git is just a means to an end. Heck, it’s usually a means to a means to an end: it is only a tool for version control of code, and the code itself is just a means to education or running the actual business.

by janalsncm

2/25/2026 at 9:16:33 AM

It can be that. In the same vein, playing a guitar can just be the means to an end. Some people play music to get paid. Do you think playing your 60th wedding gig feels beautiful or meaningful?

I personally think git is a marvel of engineering. Hackers are people who are capable of seeing beauty in systems. We're at least nominally on "hacker news", even though a better name might be "VC news".

by tovej

2/24/2026 at 5:12:35 PM

The hardest thing to get people to, is to think of a evolution of their codebase as opposed to just a single state with a sophisticated backup system. Writing proper commit messages and diffs follows from that. The actual Git commands are then incidentally.

by 1718627440

2/25/2026 at 6:12:13 PM

I haven’t used jj but isn’t that exactly what it’s meant to be?

I believe git is architecturally sound and well designed, but the command line syntax can be overly confusing and opaque.

by jimbokun

2/24/2026 at 11:30:36 PM

Git has poor design because it forces users to learn its model of things rather than meeting users where they are. There’s way too many leaky abstractions that pop out as soon as you stray from the happy path, and you might not even know you’re straying when you do it.

Instead, the complexity of your mental model should scale with the complexity of the thing you’re trying to do. Writing a “hello world” in Java does not require a mental model of all of the powerful things Java can do.

We want CS 101 students to use version control but for a lot of them it will also be their first time using a CLI and a programming and also the underlying CS concept.

by janalsncm

2/25/2026 at 11:17:59 AM

> Git has poor design because it forces users to learn its model of things rather than meeting users where they are.

If the users are unwilling to put even a minimum of effort and thought into it, that is pretty much impossible. I see that as the main problem.

by Hendrikto

2/24/2026 at 2:44:36 PM

Right on. Git is good at what it does, but its CLI is too low-level. It feels more like an assembly language than an end-user language, and a haphazard one at that.

There are wrappers that make it much more approachable. IntelliJ’s Git frontend, for example, is pretty nice.

by owlstuffing

2/25/2026 at 12:39:32 AM

IntelliJ's Git frontend makes the Git command line look like a relic for people who would rather type "outlook forward email" than use a GUI. I was disappointed they gave up their attempt to make it a standalone app.

by Noumenon72

2/24/2026 at 3:53:24 PM

Git is a cli software. If you find yourself repeating a set of commands, what you should do is abstract it using an alias or a script. And you will have you own nice interface.

by skydhash

2/24/2026 at 7:53:52 PM

My git experience got a lot better after I built scripts and customized the git config files to fully exploit:

  git-log --graph --reflog

  git-commit --amend

  git-cherry-pick

Also, becoming fluent with creation of and switching between local, short-lived branches.

With the above in order, I found I could subset the git state model:

* temporary branches rather than the "stash"

* commit tentative work to HEAD; amend, discard or set aside in a temporary branches rather than as later discoveries require

* side-step the index/cache/staging_area for most operations -- transfer directly between work tree and HEAD commit

by everybodyknows

2/24/2026 at 6:04:05 PM

That's a cop out. Not every CLI sucks so bad it needs a wrapper.

by esafak

2/24/2026 at 11:04:30 PM

No it's not -- powerful CLIs with lots of features are made to be wrapped

by eigencoder

2/24/2026 at 11:39:12 PM

Even as a CLI it’s not great. git checkout is extremely overloaded.

by janalsncm

2/25/2026 at 4:24:28 AM

Not really. The basic entity of git is the commit and git checkout is meant to restore the working tree to the state when the commit has been created. It may act on the whole tree, a specific part and if no commit has been specified, it uses the index as the source. And with branches being just pointers to commits, it's quite easy to see where the range of options comes from.

Git has its model for version control and it's something that most tutorials don't explain. The CLI is giving you maximum control over this model. For daily operations, it's quite easy to wrap it in a much amenable interface.

by skydhash

2/24/2026 at 2:12:03 PM

Very true, though it has improved a over the years. Most people haven't noticed because when git has introduced newer simpler commands it hasn't deprecated the old ones. You can now use it like this, but most people don't know it:

git switch some-branch # edit files git restore file2 # undo changes to file2 git stage file1 git commit

Instead of the old workflow using checkout with a bunch of different flags.

I agree though that git is needlessly obtuse. I advocated for mercurial instead of git for years because mercurial was so much more user friendly, but git won. I hear good things about jj now

by krupan

2/24/2026 at 4:25:24 PM

For UI/UX arguments on professional grade software, I present the Bloomberg terminal. A fever dream in shades of orange, black and blue.

For professional work, people can and do learn complex interfaces and jargon, if it is advantageous.

by intended

2/24/2026 at 2:30:33 PM

Git is badly designed, but your rule is also bad.

If somebody can get a lot done with a tool, then it's a good tool. And a lot of tools can't both enable people to get things done and avoid being misused. They have to pick one.

by marcosdumay

2/24/2026 at 2:58:20 PM

> If somebody can get a lot done with a tool, then it's a good tool.

Does "getting it done with pliers" make them a good wrench?

by owlstuffing

2/24/2026 at 3:42:05 PM

If somebody has some technique that screw things with pliers that are much faster and reliable than a wrench, you not being able to replicate it doesn't invalidate that person's usage.

Now, until such a person exists, ridiculous counterexamples are still ridiculous.

by marcosdumay

2/24/2026 at 12:49:08 PM

This feels harsh. Engineers have an endless list of other things to learn that are arguably more important, and it isn’t always worth understanding all the weird edge cases that almost never pop up (to say nothing of Git’s hostile, labyrinthine UX that one would have to deal with).

by npinsker

2/24/2026 at 3:42:45 PM

What things to learn are more important for "engineers" than using VC messages and history for communicating adequately (including communicating with themselves in the future) and using VC merging, staging etc. to put source code in a good state that they intend to build, share and archive? Irreproducible or incomprehensible work is worse than nothing.

by HelloNurse

2/24/2026 at 5:19:20 PM

That’s akin to saying the most important thing for an author is to use a word professor correctly.

by 9dev

2/24/2026 at 6:41:03 PM

I'd argue its like saying its important for an author to write an entire book using ed.

by irishcoffee

2/24/2026 at 1:21:08 PM

It's absolutely worth taking the time to learn `jj`, for example, but `jj`'s ideas build on top of `git`'s ideas. If you don't know why it's important that commits reference their parents, for example, that's limiting your knowledge of how VCS works in important ways.

A compromise/synthesis: everyone should absolutely learn how git works internally, but not necessarily how to use the git-specific porcelain/tooling/CLI

by gcr

2/24/2026 at 7:00:50 PM

A big part of the problem is being permitted to teach this stuff. As a UK CS grad from the early-2000s, my observation was that academic staff recognized the need for these skills. They weren't permitted to teach it due to time available and the view that it wasn't academic. Thankfully, my university's CS department offered courses in these kinds of topics taught by the support staff (read: sysadmins). These courses existed to help other departments with skills but were open to students.

Fast forward twelve years and my wife did the MCIT at UPenn (https://catalog.upenn.edu/graduate/programs/computer-informa...) where git and other topics woven into the curriculum. Even then, they were perhaps a novelty because their focus was bringing non-CS undergrads into a CS Masters program. So-called "conversion" master's degrees were the norm in the UK in 2002.

by zerkten

2/24/2026 at 12:48:45 PM

It seems most people learn git only through necessity. I've heard people say "I just want to code, I don't care about the peripherals". JIT learning is a good way to acquire capabilities with real-world application, but there is not JIT pull that forces people to learn about bisect, git objects, git logging, etc. These things can only be learnt either through setting off time to read documentation or by being taught through a course.

I think this is a good argument for teaching git, and being thorough in doing so, as many people are likely to never take that initiative themselves, while the benefits to being good at git are so obvious.

by TonyStr

2/24/2026 at 12:59:04 PM

I think most people learn git through the particular processes that are established at their workplace, as every company uses git or VCS in general differently somehow.

by Anonyneko

2/24/2026 at 3:56:27 PM

I see this enough that I don’t bother ranting about it. There’s the free “Pro Git” (on the git homepage) that will teach you most of what you”ll need in a lifetime. But you tell people about rebase and the reflog and their eyes glaze over.

by skydhash

2/24/2026 at 3:45:33 PM

>It seems most people learn git only through necessity. I've heard people say "I just want to code, I don't care about the peripherals"

I'm sure there's an element of (intellectual) laziness too, but I think people tend to only learn git by necessity because git is simply unpleasant to use.

A lot of us have Stockholm syndrome because git is less bad than what came before it, but git is not good.

by stackghost

2/24/2026 at 2:24:50 PM

I have heard of each of those tools but I've never really used them for real.

Like, I attempt to write good commit messages and stage my changes in such a way that the commits are small, obvious, and understandable. That's about it. But the advanced tooling around git is scary ngl.

by sigbottle

2/24/2026 at 2:30:22 PM

My rite of passage towards git kung-fu was committing to Linux kernel. It's brutal there, you have to have your history really clean.

Meanwhile enterprise teams are often like - who cares, let's auto-squash all commits into one.

by oytis

2/24/2026 at 2:59:30 PM

Your workflow makes sense for FOSS projects, where the commit is the unit of work. In my experience, on most professional teams, the PR is the unit of work. PRs trigger CI/CD pipelines. PRs map to tickets. The meaningful commit goes with the squash merge to the shared dev/main branch.

There are cases where I've staged commits this way for a PR, to make it more reviewable. I'd usually rather split them off into separate PRs, but when that would create a pipeline of three MRs that are meaningless on their own, then rewriting history for a single MR makes sense. I generally consider my feature branch's commit history to be for me, not for you. Going back and rewriting history is a chore that shouldn't be necessary if I did a decent enough job with the PR description and task decomposition. Those commits are getting squashed anyway. Along with all the "fix MR comments" commits on top of it.

It wouldn't bother me to adopt your workflow if it fits your team and its tools and processes. I'd just say, consider that your way isn't the only correct way of doing things. Your preferences are valid, but so are others'. The only thing that really bothers me is absolutism. "My way or the highway."

Your writing here reminded me of a particularly unpleasant coworker I had in the past. I quickly browsed your comment history to make sure you're not him... Excessive rigidity is not an endearing quality.

All that being said, I have also been constantly annoyed by people with too many YoE who can't be bothered to spend an hour or three to learn the basics of how the Git tree is structured, and what merge vs rebase does. They rely too heavily on their GUI crutches and can't fix anything once it goes sideways. Even when you lead them to water, sending them reading material and offering to answer questions after, they refuse to drink. Willful ignorance is far more irritating than stubbornness. I don't expect them to be able to remember what bisect vs cherry-pick does. Claude will spit out the subcommands for them if they can describe what they need in English. But they can't do that if they have no understanding of the underlying data structures...

by sh34r

2/24/2026 at 2:00:30 PM

So much this. Once you get beyond the very basics, git is a code editing tool as much as your editor/ide is

by krupan

2/24/2026 at 4:17:48 PM

I don't think using git should necessarily be taught as a part of a CS education. Any self respecting engineer will be capable and have the curiosity and motivation to dig into it on their own. CS should give them the prereqs to do so, such as hashing, graphs, trees, etc.

by barnacs

2/24/2026 at 3:44:16 PM

"Almost no CS program teaches proper version control"

This is just false. In the UK, you would learn version control in the first week, then submit all work through version control for the whole course.

I find it hard to believe that Americans just don't use version control at school. It doesn't make any sense.

by Stevvo

2/25/2026 at 11:38:40 AM

> It doesn't make any sense.

Exactly. But that is sadly the state of things.

by Hendrikto

2/24/2026 at 6:00:13 PM

This might be a good time to teach jujitsu, before they're too invested in git.

by esafak

2/24/2026 at 5:15:18 PM

Version control isn't the only thing like that (though it might be the most important). They ought to have some familiarity with the idea of a bug database, for example. A requirements database (a software engineer could go through their entire career without having to ever touch one, but they should be familiar with the idea).

by AnimalMuppet

2/24/2026 at 12:11:36 PM

One of my large enterprise clients currently requires all tech staff to complete 18h (yes, eighteen hours!) of "agile training", in addition to speed-running 14 separate mandatory online courses.

This time would be much better spent watching these 9h of lectures.

by pards

2/24/2026 at 1:14:28 PM

I'd include sed and awk, because these tools are ubiquitous and can accomplish in a few readable lines what people write long programs to handle in other languages, seemingly because they are unaware of sed and awk, don't know how to use them, or are required for some reason to do it in the project language.

In fact, generally teaching people to select the right tool for the job is a good skill to prevent them from using golden hammers.

by projektfu

2/24/2026 at 5:45:05 PM

When I was a Physics Ph.D. student in NYU in the late nineties, I took a course called UNIX tools in the CS department. It was a hands on course where the instructor did live REPL in the terminal and we watched him showing us all the tricks. I got hooked with UNIX since then. Got myself a dialup terminal in my tiny apartment in east village and dial in to the workstation on campus. The latency is so bad that I can’t only see the feedback after a few keystrokes. That was when I trained my vi muscle memory. (EMacs was out of the question.)

Later I got my own IBM 386 and installed Linux on it and started to program in Perl …

I am a big fan of Jon’s YouTube videos on Rust and I started to use Rust in non conventional ways.

I am going to follow this lecture series and “port” them to rustdoc and see how it goes.

Another rabbit hole to fall down, it is going to be fun.

https://ontouchstart.github.io/rabbit-holes/missing/

by ontouchstart

2/24/2026 at 3:04:39 PM

Just wondering - do you include information on interviewing, salary negotiation, communication with management, leading teams, and maybe topics on career progression?

These would have been very useful to me back when I was in the university.

by Arun2009

2/24/2026 at 7:03:30 PM

Not at the moment, but it's a good idea for the next iteration of the class!

by Jonhoo

2/24/2026 at 4:05:30 PM

If you want to master the shell (it will save years of your life), follow these guides. I highly recommend reading the entire BASH manual, it will answer every question you'll ever have, or at least give you a hint about it, as well as expose you to all the hidden knowledge (some call it "gotchas") you'll wish you knew later.

  101
  - Bash for Beginners (https://tldp.org/LDP/Bash-Beginners-Guide/html/)
  - Bash Tutorial (https://www.w3schools.com/bash/)

  201
  - Bash Programming (https://tldp.org/HOWTO/Bash-Prog-Intro-HOWTO.html)
  - Advanced Bash Scripting Guide (https://tldp.org/LDP/abs/html/)

  301
  - The Bash Manual (https://www.gnu.org/software/bash/manual/bash.html) (https://man7.org/linux/man-pages/man1/bash.1.html)
  - ShellCheck (https://www.shellcheck.net/)

To find every Unix-y program and get a 1-line description of it (and referenced programs/functions), run:

  for i in $(ls /bin/* /usr/bin/* /sbin/* /usr/sbin/* | sed -E 's?.*/??g' | sort -u) ; do
    echo "command: $i"
    whatis "$(basename "$i")" | cat
    echo ""
  done | tee command-descriptions.log

View 'command-descriptions.log' with less command-descriptions.log, use arrow-keys and page up/down to navigate, and type 'q' to exit. To find out more about a program like df(1), run man 1 df.

by 0xbadcafebee

2/24/2026 at 9:32:26 PM

I think looking at some of the documentation for oils (née oil sh) and ysh - as well as [looking at using] these two projects [in place of bash] - is also a good idea today:

https://oils.pub/

by e12e

2/24/2026 at 10:42:58 PM

I think I would do it more like:

  find /bin/ /usr/bin/ /sbin/ /usr/sbin/ -executable -type f -exec whatis "$(basename {})" \; | sort -u > commands.txt

by zahlman

2/24/2026 at 11:36:18 PM

You would need to make those double-quotes into single-quotes. Double-quotes will interpolate the $() immediately, running basename before find runs. Single-quotes will not interpolate the $(), so the whole string gets passed to find for it to execute each time

by 0xbadcafebee

2/25/2026 at 12:14:58 AM

It worked when I tried it. Upon investigation, this is because `basename {}` returns `{}`, which is interpolated; thus the exec just uses the full file paths; but as it turns out, `whatis` works fine with those paths.

It won't work with single quotes because `find` won't do that interpolation when it processes the `-exec` arguments; `whatis` ends up receiving a string with a literal dollar sign etc.

I think the kind of interpolation I originally had in mind isn't possible with `find`. Thankfully it apparently isn't needed (at least with my local `whatis`).

by zahlman

2/24/2026 at 6:20:39 PM

Purdue CompE has long had a 1 credit hour course that is just this. Lots of bash and git and then a little Python and Tkinter at the end. Other courses them assumed we had this knowledge - the 300-level ASIC class had us submit assignments by pushing to a remote, for instance. Definitely one of the most useful credit hours I had.

by whateveracct

2/24/2026 at 11:50:33 AM

Not an entire semester, but I'm really glad my uni had a semester long core CS course on exactly this. Still one of the most useful courses I've ever taken, I refer my notes from that class even now.

by ILoveHorses

2/25/2026 at 3:07:52 PM

I think we might need to take a hard look at the higher end path of CS and ask why we're not focused more on Software Engineering.

Research is great, but if wre trying to train people to make real things, there's a whole different set of skills where you only need a thin vineer of CS training and a deeper understanding of software maintenance.

by btreecat

2/24/2026 at 12:30:28 PM

Is this going to be like when Sun paid universities to use/teach Java? Just with Anthropic and LLMs?

by andersmurphy

2/24/2026 at 12:56:18 PM

I don't think students in 2026 need any encouragement to use LLMs, but sure, it would be strange if the LLM companies didn't give away student plans cheaply.

by dmurray

2/24/2026 at 2:09:03 PM

I don't see the lock in effect (such as learning a language, or a complex software product) with LLMs yet that would drive student based marketing efforts.

by Cerium

2/24/2026 at 8:28:59 PM

Recent changes in Claude Code show the tendency of locking in.

by blks

2/24/2026 at 4:46:11 PM

That means you need more marketing. Coke isn't popular because of lock in.

by jayd16

2/24/2026 at 11:43:37 AM

> In particular, we’re curious to hear the community’s take on our inclusion of AI-related topics

I think this is fine and if anything you should give it more space. It doesn't replace foundational understanding, but the course is explicitly about "practical" aspects, we can assume said foundational understanding is developed in other courses.

Something like "build your own agent" would be a great intuition pump. The model is doing the heavy lifting and a basic harness is a couple hundred lines of simple code. It could fit in a single lecture and it would be very high signal in my opinion.

by qsort

2/24/2026 at 3:05:03 AM

At first, the purple links had me convinced that I'd already clicked on them.

by badc0ffee

2/24/2026 at 5:05:53 PM

In terms of shell, I moved to the fish shell 5 years ago.

Things are so much easier. No need to a massive amount of plugins and configs, mostly works out of the box.

by caillou

2/24/2026 at 9:36:26 PM

Fish is probably a good idea for an interactive shell. Osh/ysh might be a good idea for scripting:

https://oils.pub/

I'm still using bash out of habit, though. My one nod to modern tooling is using fzf for shell history search...

by e12e

2/24/2026 at 5:32:49 PM

xonsh user for 8 years here :-)

I agree that these shells are better than bash, etc. But some bash knowledge is probably a must, given its ubiquity. You're not always going to have the option to install fish.

(Sadly, most of my jobs, including my current one, require tcsh).

by BeetleB

2/24/2026 at 5:20:27 PM

That's actually brilliant! Most of my classes only taught what tools were needed to accomplish coursework, not generally useful tools. Even our OS class focused on the workings of the kernel, not the Unix philosophy and how it influenced what tools were included, and how to use them. Then again, 20 years ago the year of the linux desktop was much farther away than it is today...

by ghc

2/24/2026 at 12:07:49 PM

In some way this could be the most important course.

You don't appreciate it when you're studying, because obviously it sounds a bit soft. But when you're learning how something works, often the thing that stops you isn't the fundamentals, which you know what are, it's the little frustrations like not knowing how to commit or pull code, or not knowing how to navigate the terminal.

by lordnacho

2/24/2026 at 2:31:43 PM

Personal hygiene is worth a mention.

by ludicrousdispla

2/24/2026 at 12:51:06 PM

I have a bit of unsolicited feedback (in this terms): the basic IT skills, not CS or CE, but IT, that everyone needs but most don't realize, including techies who often stay in their bubble and don't truly understand the classic desktop model despite having the skills to do so, are a bit different IMVHO:

- first of all, you need to know how to manage your own digital information. Even though it's taken for granted that a CS/CE freshman knows this, well, in my experience, that's usually not the case also for many PhD... Information management isn't just a taxonomy of files and dirs; it's also about evaluating, for example, what happens if the software you use for your notes is discontinued, or if your photo gallery disappears, and so on, and acting accordingly knowing your SPOFs and how to mitigate them;

- then you need to know how to write, in the broadest sense, which includes mathematical notation, generating graphs, "freehand" drawing like simple CAD, and formatting your work for various purposes and media, whether it's emails, theses, reports, or general messages. This is where teaching LaTeX, org-mode, R/Quarto, etc comes in. It's not "advanced" is the very basic. Before learning to program and no, Office suites are not an answer, they are monsters from a past era, made to makes untrained human with little culture to use a computer for basic stuff instead of typewriters, a student is not that;

- you need to know how to crunch numbers. Basic statistics are useful, but they're largely stuck in another era. You need to know how to do math on a computer, symbolic computation, whether it's Maxima or SymPy, doesn't really matter, and statistical processing basis. For instance, knowing Polars/Plotly/* at a minimum level are basic skills a freshman should have at a software/operational level, because they should be working in these environments from day one, given that these are the epistemological tools of the present, not paper anymore.

Then you also need to manage code, but in the broadest sense. A dSCM is also for managing your own notes and documents, not just software, and you need to know how to share these with others, whether it's Radicle or Forgejo or patches vua mail doesn't really matter, but this family of software needs to be introduced and used at least at a basic level. A DynDNS services should be also given so anyone could try to self-host the services they want.

Knowing how to communicate is an essential skill, and it's not about using Gmail or Zoom... it's about learning how to self-host basic communication services. It doesn't really matter if it's XMPP, Matrix, or Nostr, but the concept must be clear, and understanding the distributed and decentralized options we have today is vital. A student needs to learn how to stand on their own two feet, not on someone else's servers.

These are basic IT skills that aren't "advanced" at all, despite what many people think, or "sysadmin-level" and so on; they're simply what a freshman should have as someone who loves knowledge and wants to get their hands dirty.

by kkfx

2/24/2026 at 11:14:21 PM

I work in IT and can’t tell you the number of talented software engineers I’ve worked with who were just as bad (or worse) than the most tech illiterate HR person you could imagine. I’d add basic troubleshooting methodology to this list. So many engineers assume they know the problem and start headbashing a fix without bothering to evaluate the scope of a problem, form a hypothesis, or validate that their assumed fix actually worked.

by mcmcmc

2/24/2026 at 8:25:35 PM

I would omit agentic “coding” all together.

by blks

2/24/2026 at 4:15:38 PM

How about including a course in touch-typing that emphasizes the computer keyboard rather than the typewrite keyboard?

by stevetron

2/24/2026 at 3:09:46 PM

maybe would be interesting to include a lecture on how to interact with the open source community and successfully contribute to an open source project while respecting maintainer time and energy (and other unwritten rules of (n)etiquette).

edit: already in the "beyond the code" section... cool!

by a-dub

2/24/2026 at 6:11:38 PM

Huge blindspot, especially with all the AI coding going on now... Testing

by __mharrison__

2/24/2026 at 2:54:40 PM

Honestly shocked ethics aren't discussed more as the "missing semester," too many devs are completely fine working for truly evil companies.

by shimman

2/24/2026 at 4:01:31 PM

MIT already has an excellent class on Ethics for Engineers: https://e4e.mit.edu/

by anishathalye

2/24/2026 at 6:35:48 PM

Clearly failing the students seeing how they still work for evil companies.

by shimman

2/24/2026 at 3:56:24 PM

Is a moral compass something you can teach someone in a short course if they have been lacking it so far in their entire lives?

by bruce343434

2/24/2026 at 3:23:15 PM

Especially considering proper licensed engineers often due have to take engineering ethics courses as part of their program.

by wps

2/24/2026 at 3:15:33 PM

I'd suggest adding software testing and QA, particularly with the rise in AI and agentic coding requiring better testing skills, but that would deserve an entire separate course all of its own.

by ThrowawayR2

2/24/2026 at 8:17:25 PM

I would hope any CS/Software engineering education would already include QA. Both a testing course and a general software quality course.

by tovej

2/24/2026 at 2:05:17 PM

I would focus more on being able to follow the development of new and existing foundational technologies, rather than focusing on, say agentic coding. That one really sticks out as a trendy topic that doesn't really deserve to be included.

by tovej

2/24/2026 at 3:59:46 PM

This is great but irrelevant in the age of ai.

by DGAP

2/24/2026 at 4:11:01 PM

[dead]

by snowhale

2/24/2026 at 9:33:43 PM

To watch

by vibecodingfraud

2/24/2026 at 8:46:59 PM

As it's hosted on CSAIL, I was somewhat disappointed by the code quality section:

https://missing.csail.mit.edu/2026/code-quality/

Although it's specifically code quality, not software quality, I feel so much is missing. Of course there is no space to explain it in detail, but they could at least list/mention things like complexity, maintainability, modularity etc.

by dvfjsdhgfv

2/24/2026 at 9:41:40 PM

I am not at lecture 9 yet. I would love to follow their journey at human pace just like I did 30 years ago.

I do think your point is valid. The trend in the industry is putting emphasis on cosmetic qualities (format, workflow, testing), producing huge amount of metadata that consumes huge amount of human and machine energy for the peace of mind.

Complexity, maintainability, modularity have more to do with thinking about the problems at proper abstraction levels.

It seems we ended up spending more time on tools like writers spending more time on sharpening pencils or playing with fonts than writing something meaningful.

A low quality software can have beautiful code just like a low quality book has beautiful fonts.

by ontouchstart

2/24/2026 at 9:47:26 PM

I watched this YouTube video

Two decades of Git: A conversation with creator Linus Torvalds

https://www.youtube.com/watch?v=sCr_gb8rdEI

I was surprised that he only spent four months on it as a maintainer. What a great piece of work by a great software developer.

by ontouchstart

2/24/2026 at 5:30:54 PM

I didn't even have to look to know that they'd added a section on AI sloperators.

Want my feedback? Delete the AI bullshit and go back to teaching programmers how to learn and understand what they are building.

by cratermoon

2/24/2026 at 8:38:05 PM

[dead]

by umairnadeem123

2/24/2026 at 11:13:53 PM

[dead]

by dfilppi

2/24/2026 at 2:06:52 PM

Lol, does any of this matter anymore with AI coding? It was hard to get people to care about this sort of thing before ai coding, now its impossible. People in a few years will be coding without even knowing what unix is.

by nautilus12

2/24/2026 at 12:35:06 PM

Is there even a point learning CS now with the rapid progress of agentic coding? It seems like a complete waste of money and time.

by mono442

2/24/2026 at 1:51:45 PM

Yes. Agents are good at solving densely represented (embarrassingly solved) problems, and a surprising and disturbing number of problems we have are, at least at the decomposed level, well represented. They can even compose them in new ways. But for the same reason they would be unable to derive general relativity, they cannot use insight to reformulate problems. I base this statement on my experience trying to get them to implement Flying Edges, a parallel isosurface extraction algorithm. It’s a reformulation of marching cubes, a serial algorithm that works over voxels, that works over edges instead. If they’re not shown known good code, models will try and implement marching cubes superficially shaped like flying edges.

You are still necessary to push the frontier forward. Though, given the way some models will catch themselves making a conceptual error and correct in real time, we should be nervous.

by zjp

2/24/2026 at 2:03:18 PM

I've had the same experience. I do a lot of automation of two engineering software packages through python and java APIs which are not terribly well documented and existing discussion of them on the greater web is practically nonexistent.

They are completely, 100% useless, no matter what I do. Add on another layer of abstraction like "give me a function to calculate <engineering value>" and they get even worse. I had a small amount of luck getting it to refactor some really terrible code I wrote while under the gun, but they made tons of errors I had to go back and fix. Luckily I had a pretty comprehensive test suite by that point and finding the mistakes wasn't too hard.

(I've tried all of the "just point them at the documentation" replies I'm sure are coming. It doesn't help)

by operation_moose

2/24/2026 at 12:38:25 PM

If you regard a CS degree as vocational training to "code" then perhaps not - but I don't think that's really how people should be regarding a CS degree?

by arethuza

2/24/2026 at 12:49:18 PM

Most people treat higher education as a pass to good paying job and I think it's unrealistic to think otherwise.

by mono442

2/24/2026 at 3:32:35 PM

> Most people treat higher education as a pass to good paying job and I think it's unrealistic to think otherwise.

Yes, and that's a problem. If the advent of coding agents leads to people that are only in it for the money staying away from higher education - good. Those people are the reason why higher education turned to shit anyway and maybe it will be a nice change when people go into higher ed out of curiosity and not because they smell money.

by plastic-enjoyer

2/24/2026 at 6:24:44 PM

On one hand I agree, since I see way too many dispassionate people working in this profession, on the other hand this requires businesses to understand, that a software developer is more than a code monkey. I am not sure we are heading there. Currently, it seems more like many non-IT people think that their monkey imitations are the same that software developers have been doing for years and that they now don't need any good developers any longer. For some CRUD businesses this might even be true.

by zelphirkalt

2/24/2026 at 12:53:27 PM

Is that "pass" still worth it though? NB I have no idea - ~40 years since I did a CS degree!

by arethuza

2/24/2026 at 1:10:27 PM

Is there any point in teaching aviation engineering when an LLM could probably generate something that looks reasonable from a corpus existing work?

by projektfu

2/24/2026 at 1:21:51 PM

Most “cs” students don’t work in aviation, majority (statistically) work on yet another SaaS that is a CRUD that has been solved millions of times already.

by wiseowise

2/24/2026 at 1:26:46 PM

> majority (statistically) work on yet another SaaS that is a CRUD that has been solved millions of times already.

Not necessarily going to be true by the time current first year students graduate, given that solved problems are most exposed to AI acceleration.

by oytis

2/24/2026 at 8:35:13 PM

I think it's a bit like `rails generate`, where it massively speeds up getting a CRUD webapp 0 to 1, but once you get to GitHub or Shopify size, you need a lot more than that to add a new data model.

AIs are pushing many things forward, but due to training sets and context windows, I think meaningfully adding to actually valuable apps, at least as we currently write them (the kind with many DBs/caches/message queues, services) will take a fair bit longer.

by srpablo

2/24/2026 at 2:46:21 PM

Why wound it change?

by wiseowise

2/24/2026 at 2:48:52 PM

Because the companies doing these will either not employ as many people as they do now or will cease to exist altogether since their customers will not need their services

by oytis

2/24/2026 at 2:02:55 PM

Depends on whether one wants to be a software engineer or a mere LLM operator.

To be fair to the parent poster, many people do seem to aspire only to be LLM operators, who will be a dime-a-dozen commodities accorded even less respect and pay than the average developer is today.

by ThrowawayR2

2/24/2026 at 12:59:46 PM

Computer science and coding are as related as physics and writing. If your thesis is the LLM can replace all of science then you have more faith in them than I do. If anything the LLM accelerates computer science and frees it from the perception that it is coding.

by ModernMech

2/25/2026 at 4:17:06 AM

I would remove the AI stuff entirely. At best it's not useful for students to learn about AI, at worst it's actively harmful (because they will rely on it and never learn). AI isn't yet to the point where it's actually a useful tool, so it doesn't make sense to devote learning time to it.

by bigstrat2003