Click here to Skip to main content
15,065,644 members

Comments by kanalbrummer (Top 3 by date)

kanalbrummer 11-Jan-16 23:01pm View
Reason for my vote of 5 \n Fine idea, thanks for sharing.
Added this article to my favorites!
kanalbrummer 16-Sep-13 8:54am View
Reason for my vote of 5 \n Thanks for sharing.
Reading and viewing DXF files looks very interesting for me.
kanalbrummer 28-Aug-12 1:54am View
Reason for my vote of 5
Fully agree.

In the age of intellisense, it is very easy to use longer and descriptive variable names.

If a constant needs to be commented, I write something like this // first shipment has this index

Having longer names eases renaming a variable with search-and-replace. Imagine you should rename a variable named i. It is much more easy to rename a variable named nShipment.

In contrast, functions should be commented well: Functionality, input params, return value and side effects (if any) etc. Sometimes you need to comment if an object should be deleted externally or if the object will be deleted within the function. Also index boundaries shall be commented (included boundary)