Cosmetic Changes shouldn’t block Software Development
The most valuable thing a software team can do is ship. Users care about functionality, about experience, not about your SDLC, your agile rituals, or your naming conventions.
SDLC exists because collaboration needs structure, and structure is overhead even when necessary. Every round of the cycle takes time. Write, review, test, merge, deploy. SDLC slows you down by definition.
A healthy ratio is 80% real work, 20% overhead from the SDLC. I have seen it inverted. Developers stuck in the procedure, not the product. Five times the capex for the same result, and developer time is already the biggest line item in most companies. That is the spend, but the real cost is the release you never made.
Cosmetic changes#
Functional changes justify the overhead. Cosmetic ones cost the same but return nothing.
Cosmetic changes do not alter what the software does. Renaming variables, re-arranging files, tweaking function signatures, adjusting documentation. The user does not care whether the variable is numberOfVisitors or visitorCount. If the users would not notice, the change is cosmetic.
Cosmetic suggestions cost nothing to make. A reviewer fires one off in minutes. The author pays in hours or days spent revising, re-reviewing, waiting for CI, waiting for approval. Clean names and clear docs make a codebase easier to work with. The problem is not the change but what it costs.
Worse, many cosmetic fixes are pointless. Features routinely get dropped or rewritten after the first round of user feedback, so polishing before something has proven itself is wasted effort.
This is most acute in startups and teams racing a deadline. Two days to users beats five days to pretty code.
Ship today, refine later#
Cosmetic work has its place, but not at the expense of functional work. Cut it down, handle it all at once every week or two.
If the code works and the change is superficial, do not let it lock up the release.
The point of the SDLC is to ship better software, but if it stops you from shipping at all, it has failed its only job.
Reach out at blog @ moralestapia.com