Debug: First Real Session2026-03-30

Notes

As I shipped more, small changes started surfacing UX or display issues; I learned to name the problem first, then pick where to fix.

After I added comments, what I really cared about was whether visitors could finish “leave a note” smoothly, and whether what they saw felt trustworthy and free of obvious bugs. At first, the comment area felt inconsistent between the first paint and what happened after you interacted. I framed it as a product question first: does the first screen match the actual experience, not as an implementation puzzle. The direction I chose was to let the form show up fully in the environment where people actually type, so we don’t get two different stories between “landing” and “using.”

Time stamps were another issue: if a comment says Invalid Date, that reads as “this information is broken.” My rule became simple: don’t mirror obvious junk to users. Understand what the third-party service actually returns, then decide what to show—show a human-readable time when we can; when we can’t, I’d rather show nothing than a scary string.

A few fixes were about experience cost: after posting, the whole list flashed, but moderated comments don’t appear instantly anyway—so that refresh added motion without new information. I removed it. Dropping the email field reduced hesitation at submit. On the projects list I added a comment count badge so I can see where conversations are actually happening—more like closing the feedback loop than staring at static blurbs.

After many iterations I hit a recurring situation: “I already changed it—why hasn’t the site moved?” Sometimes I simply hadn’t committed or pushed, so production stayed on the previous release. Sometimes production was already updated while local preview looked stale—then I check I’m on the same repo and branch, restart dev with a reliable setup, and occasionally clear the local build cache. A few times the port shifted (3001, 3002…) because the default was taken, and I was still staring at the old URL, thinking nothing had changed. I now treat localhost preview and the live domain as two environments: if it isn’t shipped, visitors don’t see your version. When local and production disagree, I first align code sync, which dev process I’m actually running, and whether I’m on the right address—before I doubt that I edited the wrong thing.

So this round of debugging feels closer to day-to-day product work: state the problem clearly (who it hits, what it looks like, what “good” is), then decide whether to fix presentation, data, or the release path. Fewer blind “try one line” attempts; more asking which class of problem this step actually solves—a small but real step for me.

Comments

Loading

Post a comment

Comment is required; nickname is optional. A random nickname is used if you leave it blank. After approval, comments appear in the list above.

Comments powered by Cusdis

Back to Projects