Posted on 2026-06-23 by Akseli Lahtinen Just something I experience more and more these days. Just something I experience more and more these days. When it comes to reviewing code, the descriptions, commits and such can be massive blast of information: Full of extraneous details depicting what was changed. The main point is why was something changed. And often in only one huge commit with massive diffs. I’m sorry but my poor ADHD brain can’t take this very well. I don’t want to read a novel. Usually blurbs of text are fine: Extraneous detail I can ask about if I need to know. So this is my plea, from pure accessibility standpoint, to keep commit messages, merge request descriptions and code comments clear, to the point, need-to-know basis. Do not…
Please keep code descriptions simple
Advertisement