Practices blog.juliobiason.net

Things I learnt the hard way (in 30 years of software development)  ↦

I just started reading this (estimated read time: 34 minutes) and I have to say there are some really great tips inside. This one on code comments is pure gold:

If you have no idea how to start, describe the flow of the application in high level, pure English/your language first. Then fill the spaces between comments with the code.

Better yet: think of every comment as a function, then write the function that does exactly that.

Julio warns that many of his learnings are cynical, but it’s gotta be hard to not be cynical after 30 years in this industry…


Discussion

Sign in or Join to comment or subscribe

Player art
  0:00 / 0:00