The Elephant in the Room: Reflections on Bad Code, Industry Myths, and How to Improve Software Development

The presentation begins with an introduction to the concept of "the elephant in the room," referring to obvious problems no one dares to discuss, and explains why the speaker chose to address the pervasive issue of bad code in software development.

He observes that while beautiful, well‑structured code exists, most developers work on or inherit messy code because few can consistently produce high‑quality code, leading to widespread frustration and guilt.

The talk then outlines several industry myths: that software is easy to modify, that adding more developers speeds up projects, that programmers are interchangeable, that abstract concepts are inherently beneficial, and that specific methodologies can solve all problems. Each myth is illustrated with examples and visual aids.

Hedhman describes the consequences of these misconceptions, including rapid technological turnover, lack of experience among programmers, and a cycle of repeated mistakes that degrade codebases and morale.

He identifies the core problems as economic (hiring more developers increases cost and complexity) and social (unhappy programmers leave, worsening skill gaps). He stresses that the current development model resembles a stagnant, low‑productivity era.

Finally, he offers concrete advice: adopt the KISS principle (Keep It Simple, Stupid), avoid unnecessary abstractions and premature generalizations, and make incremental improvements to existing code. Small, collective enhancements can gradually transform a chaotic codebase into a healthier, more maintainable system.

Content source: IDCF BoatHouse open‑source project and translation by Teng Fei.