Sometimes you just need comments. I’ve written graphing algorithms that traverse databases in Ruby. I named functions well, too; but the actions I was doing wer

Sometimes you just need comments. I’ve written graphing algorithms that traverse databases in Ruby. I named functions well, too; but the actions I was doing were so weird without sufficient context that when someone might need to change it, 6 months or a year from now, they would have absolutely no idea why I was doing. And no amount of clean code patterns, nor code as documentation patterns would have clarified what was being done as much as the multi-paragraph with ascii art comment I wrote above the function. Sometimes you just need comments.