Tom Lieber's Microblog

Sep 1, 2023

When I write code that I know has noticeable limitations, I used to denote them with TODOs, but lately I’ve been writing them as disclaimers instead. Like instead of:

// TODO: Make this work for multiple cameras.

I’ll write:

// This only works for one camera.

I think it’s a good thing to write only the code that I need right now, but noting the limitations with TODOs made it feel like a liability. It also probably gave the false impression to my teammates that I intended to add unneeded features that I really didn’t.