Oracle VM Consulting
view counter

Code Comments Gone Wrong

Thanks to Eddie Awad for this story

Dimitrios Kalogirou offers good advice:

Oracle Virtualization and Cloud Consulting
view counter

Write self descriptive code ! Your code should be read like sentences. Avoid smart shortcuts and tricks because they break the reading… I use code comments when the code is not really self documenting. Comments should convey what code cannot. They should explain the reasons for a specific design decision, they should explain what code is supposed to achieve and why.

Related articles:


© Eddie Awad's Blog, 2012. |
Permalink |
Add a comment |
Topic: Tips |
Tags: programming



Read the entire article at its source

view counter