Hacker News new | past | comments | ask | show | jobs | submit login

Comments are meant to pass information to readers about rare cases that may not make much sense at first but have a reason to be.

This is to avoid the introduction of bugs by tempting someone to refactor or "fix" your code.

A properly written code, with good naming conventions for parameters, variables and functions should be easy to understand without comments.

I should not need anyone to tell me the next few lines will

//Heat oven

That should be self explanatory by just looking at the code itself.




Consider applying for YC's W25 batch! Applications are open till Nov 12.

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: