Reply to post: Re: I used to have pretty squares around comments...

Linus Torvalds in sweary rant about punctuation in kernel comments

John Robson Silver badge

Re: I used to have pretty squares around comments...

"Personally, I tend to write a lot of comments while figuring out the shape of the new code, but once the code's actually working, unless the logic is amazingly complicated or obscure (usually due to external factors), it'll all be deleted. I'm much more a fan these days of making the code itself as clear and self-documenting."

Code should say what it does - Comments say why.

POST COMMENT House rules

Not a member of The Register? Create a new account here.

  • Enter your comment

  • Add an icon

Anonymous cowards cannot choose their icon

Biting the hand that feeds IT © 1998–2019