Re:I’m a productive programmer with a memory of a fruit fly
by andirk on Monday September 19, 2022 @11:46PM
(#32907438)
> I’d much rather rewrite a comment six times
Yes! Rewrite that comment until it's sound! Being able to write in spoken language what the code is doing is so often related to the writer's ability to write that code succinctly.
Also, difficulty writing a clear, concise comment is a strong code smell indicating that you don’t sufficiently understand the following block of code. Much better to realise this at the comment stage than at the debugging stage.