Category Archives: engineering

Long Names are Long

I found a hugely insightful article on naming. It encourages concise naming, and lays out really clear principles on how to name variables well.

β€œA name has two goals:

  • It needs to be clear: you need to know what the name refers to.
  • It needs to be precise: you need to know what it does not refer to.

After a name has accomplished those goals, any additional characters are dead weight.”

https://journal.stuffwithstuff.com/2016/06/16/long-names-are-long/

Production Troubleshooting Methodology

Production issues are among the most demanding challenges a software team can face β€” especially when they occur in environments outside your direct control.

To navigate these situations effectively, this methodology draws inspiration from the OODA loop (Observe, Orient, Decide, Act), a strategic decision-making framework originally developed for military operations. The goal is to establish control, gather facts, and make deliberate progress toward resolution β€” even in the face of complex or obscure problems.

Continue reading β†’

Logging β€” our most effective debugging tool?

Logging frameworks have become a standard part of projects, since Servlets and Log4J first emerged. But how should we log? Are we getting the most we can from it?

Many developers see logging & debugging as separate tasks. When confronted with a problem we set breakpoints, step through, inspect variables, and trace through loops – often finishing hours later..

Finding problems this way is hard. Does it have to be so difficult? Could there be a way to get right to the problem area, in just minutes? Sometimes without even needing to step through? Continue reading β†’