Click here to Skip to main content
13,798,497 members

Work Issues

 
PraiseRe: How to write a programming language in Hindi? Pin
INDtanay22-Nov-17 21:19
memberINDtanay22-Nov-17 21:19 
GeneralRe: How to write a programming language in Hindi? Pin
Member 1349103923-Nov-17 5:26
memberMember 1349103923-Nov-17 5:26 
GeneralRe: How to write a programming language in Hindi? Pin
INDtanay23-Nov-17 7:01
memberINDtanay23-Nov-17 7:01 
GeneralRe: How to write a programming language in Hindi? Pin
Member 1349103927-Nov-17 18:07
memberMember 1349103927-Nov-17 18:07 
QuestionWorking with software houses / SDLC expertise Pin
JohnLBevan4-Oct-17 1:30
professionalJohnLBevan4-Oct-17 1:30 
SuggestionDrop Down Issue Pin
Member 1332500523-Jul-17 22:04
memberMember 1332500523-Jul-17 22:04 
GeneralRe: Drop Down Issue Pin
Richard Deeming24-Jul-17 9:07
mvpRichard Deeming24-Jul-17 9:07 
QuestionOf Code and Comments Pin
I.explore.code30-Jun-17 9:19
memberI.explore.code30-Jun-17 9:19 
Evening folks,

Not sure which board this question/rant belongs so I am just going to put it on here.

I would love to know how people generally feel about comments in code as a means to describe what the code does. In my workplace that I only started at about 2 months ago, I have already had about half a dozen discussions about why I think code comments are a) largely a waste of time b) distraction from writing the actual code c) give license to a developer to be sloppy with their code.

Kevlin Henney's talk on this subject is pretty much along the same lines but there must be some bigger picture that I must be missing that my colleagues in office know that they are forcing me write comments in code. I have been developing software for about 11 years professionally and 15 years if you include the pizza and soda filled days of academia and I have transitioned from code commenter to just writing clean enough code that tells the reader what it does (thanks to Uncle Bob!!) so I find it incredibly backward having to go back to writing comments just to save my job.

I do understand in some cases comments might be necessary where the code intrinsically is complex and cannot be refactored any more but putting documenting comments on every class, function and property just for the sake of it seems ridiculous. I also understand publicly consumed APIs need to have documentation so client developers can build apps on top of them but anything beyond these 2 use cases, is stupid IMHO.

Thoughts, outrages, feelings?

Cheers
IEC
AnswerRe: Of Code and Comments Pin
David A. Gray30-Jun-17 10:22
memberDavid A. Gray30-Jun-17 10:22 
GeneralRe: Of Code and Comments Pin
I.explore.code30-Jun-17 11:19
memberI.explore.code30-Jun-17 11:19 
GeneralRe: Of Code and Comments Pin
David A. Gray30-Jun-17 11:33
memberDavid A. Gray30-Jun-17 11:33 
GeneralRe: Of Code and Comments Pin
I.explore.code30-Jun-17 13:55
memberI.explore.code30-Jun-17 13:55 
GeneralRe: Of Code and Comments Pin
David A. Gray5-Jul-17 17:02
memberDavid A. Gray5-Jul-17 17:02 
GeneralRe: Of Code and Comments Pin
I.explore.code14-Jul-17 14:13
memberI.explore.code14-Jul-17 14:13 
GeneralRe: Of Code and Comments Pin
Davie2124019-Feb-18 11:43
memberDavie2124019-Feb-18 11:43 
AnswerRe: Of Code and Comments Pin
Foothill30-Jun-17 10:59
professionalFoothill30-Jun-17 10:59 
GeneralRe: Of Code and Comments Pin
David A. Gray30-Jun-17 11:30
memberDavid A. Gray30-Jun-17 11:30 
AnswerRe: Of Code and Comments Pin
Eddy Vluggen1-Jul-17 1:21
professionalEddy Vluggen1-Jul-17 1:21 
GeneralRe: Of Code and Comments Pin
I.explore.code1-Jul-17 7:50
memberI.explore.code1-Jul-17 7:50 
GeneralRe: Of Code and Comments Pin
Eddy Vluggen1-Jul-17 8:34
professionalEddy Vluggen1-Jul-17 8:34 
GeneralRe: Of Code and Comments Pin
I.explore.code1-Jul-17 10:14
memberI.explore.code1-Jul-17 10:14 
GeneralRe: Of Code and Comments Pin
Eddy Vluggen1-Jul-17 11:05
professionalEddy Vluggen1-Jul-17 11:05 
GeneralRe: Of Code and Comments Pin
I.explore.code1-Jul-17 14:33
memberI.explore.code1-Jul-17 14:33 
GeneralRe: Of Code and Comments Pin
Eddy Vluggen2-Jul-17 0:27
professionalEddy Vluggen2-Jul-17 0:27 
GeneralRe: Of Code and Comments Pin
I.explore.code2-Jul-17 2:01
memberI.explore.code2-Jul-17 2:01 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    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 | Cookies | Terms of Service
Web04 | 2.8.181207.3 | Last Updated 12 Aug 2018
Copyright © CodeProject, 1999-2018
All Rights Reserved.
Layout: fixed | fluid