Click here to Skip to main content
11,717,509 members (80,529 online)

Survey Results

Do you comment your code?

Survey period: 5 May 2014 to 12 May 2014

A repeat of our survey from 4 years ago. Let's see how things have changed.

OptionVotes% 
I add comment headers for all public classes, objects and methods, events, fields etc56740.04567 votes, 40.04%
I add comment headers for all non-public classes, objects and methods, as well as non-obvious logic inside these37226.27372 votes, 26.27%
I provide comments at the top of files29921.12299 votes, 21.12%
I comment any code that may be obscure (the "what") to a reader88162.22881 votes, 62.22%
I comment any code where the purpose (the "why") may be obscure93966.31939 votes, 66.31%
I comment on expected inputs, outputs and other results27719.56277 votes, 19.56%
I comment on exceptions, side effects or error codes31222.03312 votes, 22.03%
I comment on structures (loop endings, function endings etc)16911.94169 votes, 11.94%
I comment as a last resort when I can't make my code any clearer36325.64363 votes, 25.64%
I do not comment code.896.2989 votes, 6.29%
Respondents were allowed to choose more than one answer; totals may not add up to 100%



 
GeneralHow much commenting is actually relevant? Pin
d@nish 8-May-14 16:46
member d@nish 8-May-14 16:46 
GeneralRe: How much commenting is actually relevant? Pin
Nagy Vilmos9-May-14 0:01
professionalNagy Vilmos9-May-14 0:01 
GeneralRe: How much commenting is actually relevant? Pin
freedeveloper11-May-14 9:07
professionalfreedeveloper11-May-14 9:07 
Generalmissing option Pin
thrakazog8-May-14 11:55
memberthrakazog8-May-14 11:55 
GeneralRe: missing option Pin
Nelek10-May-14 12:09
memberNelek10-May-14 12:09 
GeneralRe: missing option Pin
thrakazog14-May-14 6:38
memberthrakazog14-May-14 6:38 
GeneralAnd what's so sad is Pin
W Balboos8-May-14 8:02
memberW Balboos8-May-14 8:02 
GeneralWhy vs. What Pin
Marc Clifton8-May-14 5:16
protectorMarc Clifton8-May-14 5:16 
GeneralOne more option : I Use Regions in my code Pin
Rahul VB7-May-14 23:04
professionalRahul VB7-May-14 23:04 
GeneralRe: One more option : I Use Regions in my code Pin
Marc Clifton8-May-14 5:26
protectorMarc Clifton8-May-14 5:26 
GeneralA missing choice Pin
aboubkr907-May-14 17:20
memberaboubkr907-May-14 17:20 
GeneralRe: A missing choice Pin
Vedat Ozan Oner8-May-14 2:27
professionalVedat Ozan Oner8-May-14 2:27 
GeneralRe: A missing choice Pin
_Maxxx_11-May-14 1:00
professional_Maxxx_11-May-14 1:00 
GeneralDan Saks, one-time secretary of the ANSI C and C++ committees, said it best Pin
Gary R. Wheeler6-May-14 13:36
memberGary R. Wheeler6-May-14 13:36 
GeneralMy Philosophy Pin
Pualee6-May-14 4:39
memberPualee6-May-14 4:39 
GeneralRe: My Philosophy Pin
Gary R. Wheeler6-May-14 13:37
memberGary R. Wheeler6-May-14 13:37 
GeneralComment for Understanding Pin
shub.goel6-May-14 1:47
membershub.goel6-May-14 1:47 
GeneralDifficult to find a fit on the options. Pin
DaveAuld5-May-14 21:01
protectorDaveAuld5-May-14 21:01 
GeneralI comment code when i don't need it any more Pin
Anurag Gandhi5-May-14 18:42
professionalAnurag Gandhi5-May-14 18:42 
GeneralPosting Articles in CodeProjec Improves My Commenting Pin
Ravimal Bandara5-May-14 17:55
memberRavimal Bandara5-May-14 17:55 
GeneralThe Only Times I Comment Pin
Joe Gakenheimer5-May-14 11:57
memberJoe Gakenheimer5-May-14 11:57 
AnswerI comment on questions regarding code commenting Pin
MacSpudster5-May-14 11:29
memberMacSpudster5-May-14 11:29 
GeneralInitial and date comments Pin
_Damian S_5-May-14 11:14
professional_Damian S_5-May-14 11:14 
GeneralRe: Initial and date comments Pin
Gary R. Wheeler6-May-14 13:41
memberGary R. Wheeler6-May-14 13:41 
GeneralRe: Initial and date comments Pin
_Damian S_6-May-14 13:52
professional_Damian S_6-May-14 13:52 
GeneralRe: Initial and date comments Pin
_Maxxx_11-May-14 1:01
professional_Maxxx_11-May-14 1:01 
GeneralDoxyGen compliant Pin
Mike Hankey5-May-14 10:59
memberMike Hankey5-May-14 10:59 
GeneralWhat About.... Pin
ledtech35-May-14 8:08
memberledtech35-May-14 8:08 
GeneralPer the tale of two developers... Pin
Duncan Edwards Jones5-May-14 7:10
professionalDuncan Edwards Jones5-May-14 7:10 
AnswerThe Ninja coder Pin
Ravi Bhavnani5-May-14 5:45
professionalRavi Bhavnani5-May-14 5:45 
GeneralRe: The Ninja coder Pin
thatraja5-May-14 6:00
protectorthatraja5-May-14 6:00 
Generaltry to code... Pin
Dennis E White5-May-14 4:23
memberDennis E White5-May-14 4:23 
GeneralCaptain obvious comments Pin
ed welch4-May-14 23:54
membered welch4-May-14 23:54 
GeneralRe: Captain obvious comments Pin
RyanDev5-May-14 1:10
mvpRyanDev5-May-14 1:10 
GeneralRe: Captain obvious comments Pin
Jahmal235-May-14 4:54
memberJahmal235-May-14 4:54 
GeneralRe: Captain obvious comments Pin
DJ van Wyk5-May-14 19:39
professionalDJ van Wyk5-May-14 19:39 
GeneralRe: Captain obvious comments Pin
Pualee5-May-14 5:05
memberPualee5-May-14 5:05 
GeneralRe: Captain obvious comments Pin
thatraja5-May-14 5:58
protectorthatraja5-May-14 5:58 
GeneralRe: Captain obvious comments Pin
Nemanja Trifunovic5-May-14 8:35
memberNemanja Trifunovic5-May-14 8:35 
GeneralRe: Captain obvious comments Pin
Dennis_E6-May-14 21:58
professionalDennis_E6-May-14 21:58 
GeneralRe: Captain obvious comments Pin
aboubkr907-May-14 17:41
memberaboubkr907-May-14 17:41 
GeneralGive credit where due Pin
Member 90635564-May-14 23:52
memberMember 90635564-May-14 23:52 
General"Sometimes".... Pin
imagiro4-May-14 22:29
memberimagiro4-May-14 22:29 
GeneralDepends on who will use my code Pin
zaxthealien4-May-14 21:02
memberzaxthealien4-May-14 21:02 
GeneralLast resort... Pin
Sander Rossel4-May-14 21:02
professionalSander Rossel4-May-14 21:02 
GeneralClasses and methods when necessary, everything else shouldn't need any comments. Pin
AlexCode4-May-14 20:53
professionalAlexCode4-May-14 20:53 
Generaladd one more option Pin
Marla Sukesh4-May-14 20:42
professionalMarla Sukesh4-May-14 20:42 
GeneralI try... Pin
Jim Meadors4-May-14 19:16
memberJim Meadors4-May-14 19:16 
GeneralRe: I try... and regret not succeeding Pin
Erik Rude5-May-14 22:41
memberErik Rude5-May-14 22:41 
General"Why" is really important than "What"...! Pin
koolprasad20034-May-14 19:04
memberkoolprasad20034-May-14 19:04 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.


Advertise | Privacy | Mobile
Web01 | 2.8.150901.1 | Last Updated 10 Aug 2007
Copyright © CodeProject, 1999-2015
All Rights Reserved. Terms of Service
Layout: fixed | fluid