Appears on
Articles2
LaTeX Coffee Stains [pdf]
Article URL: https://ctan.math.illinois.edu/graphics/pgf/contrib/coffeestains/coffeestains-en.pdf Comments URL: https://news.ycombinator.com/item?id=46526933 Points: 32 # Comments: 9
ctan.math.illinois.edu4mo ago
Rethinking Programming Advice: The Case for Comments That Explain 'What'
The article challenges the common programming advice that "comments should explain why, not what." The author argues that comments explaining 'what' can be valuable, especially when code isn't immediately clear or when dealing with complex logic. They provide examples showing how explanatory comments can improve understanding, particularly for beginners or w
Opinion
hillelwayne.com4mo ago