
Please keep code descriptions simple
A developer's personal plea for simpler, more concise code descriptions, commit messages, and merge request descriptions. The author, who has ADHD, argues that reviewers need to know the 'why' behind changes, not the 'what', and that atomic commits with clean rebases make reviews easier. Also advises against using LLMs to write commit messages and comments, encouraging developers to write them personally for better understanding and accessibility.