+ 43
we don't need to comment self explanatory code but if I got into error and found solution from somewhere I comment that to remember afterwards. But sir I don't think I comment as much as I should.
23rd Mar 2017, 6:12 PM
Ram chandra Giri
Ram chandra Giri - avatar
+ 26
if(someoneElseWillReadMyCode) commentLots(); Normally I just use self-explanatory variable names
23rd Mar 2017, 6:16 PM
Jafca
Jafca - avatar
+ 18
It's compulsory for us to write comments in source codes for extra assignment marks so yeah, I guess I do. Else, I won't even bother. One reason I can think of which seconds the idea of writing lots of comments in your code would be when you are writing a piece of code mainly for educational purposes, wherein other people would read them and understand your ways and methods. I haven't met with situations in which I needed my own hint as to what I did with codes that I wrote myself.
23rd Mar 2017, 6:19 PM
Hatsy Rei
Hatsy Rei - avatar
+ 12
In my codes here, I always try to be as commenty as possible. Sometimes too much, like in the PythonEdu series :) Another thing is when I intend a surprise, like in the Hello World case. There I don't comment at all, until the riddle is solved ;)
23rd Mar 2017, 6:29 PM
Kuba Siekierzyński
Kuba Siekierzyński - avatar
+ 12
most of the time I live by the rule: it was hard enough to write the code, so the code is documentation enough. 😈 and later when I review my own code I hate myself for that, because I have no freaking clue what I did 😭
23rd Mar 2017, 7:06 PM
Mario L.
Mario L. - avatar
+ 12
I comment if necessary. But I never add Yoda ^^
23rd Mar 2017, 8:46 PM
Tashi N
Tashi N - avatar
+ 11
Truly speaking, I hate to write comments but they are very handy in terms of understanding the code:)
23rd Mar 2017, 5:36 PM
Dev
Dev - avatar
+ 10
A good and clean code should document itself. Well-named variables and methods speak about the intent of the programmer. Sometimes, however, the code is nevertheless incomprehensible and should be documented as a comment. Comment // TODO sometimes is necessary.
24th Mar 2017, 6:23 PM
Grzegorz Kawalec
Grzegorz Kawalec - avatar
+ 8
I comment while typing and do a final editing when i'm satisfied with my work. If I expect contributions on the code I'll try to be as verbose as possible. Commenting skills as coding skills improve with practice. I remember myself writing some comments that look useless now but at that time, helped me carving the concept in my mind til the point that I can now say: "it was a useless comment".
24th Mar 2017, 12:27 AM
seamiki
seamiki - avatar
+ 6
In the first half of my career, I worked on projects that predominantly required heavy code comments. As I transitioned to agile teams committed to TDD / BDD, general code comments became a liability, rather than an asset to code quality. Our code review process focuses on readability and test coverage of our code. If we find a comment attempting to explain something in the code, we attempt to explore whether the code could be improved to clarify what ever isolated condition that was being commented. The goal is to let the readability of our code be the source of truth rather than the comments. We can trust the code and the unit tests. However, we cannot trust the comments for several reasons. 1. Comments may not be consistently thorough for all developers and all code. 2. When code changes, comments are not guaranteed to change accordingly and may not be thorough. 3. Comments cannot be validated by the compiler or via unit tests and therefore subject to human error. 4. The context of the comment may have changed as other code has changed. This could cause even more confusion if the comment carries a different meaning in the new context. Bottom line, comments are not reliable, cannot be tested or validated, and is often redundant to what can be inferred by well written, readable code.
26th Nov 2017, 6:29 AM
David Carroll
David Carroll - avatar
+ 5
i often write comments to plan out code before I write it. I don't think typing is what takes up Development time - its thinking, planning, problem solving, reading documentation (of libraries or bits of bits of the language I don't use often)
25th Mar 2017, 4:42 PM
Phil
Phil - avatar
+ 4
I always comment. It's really useful if other people are going to see your code and also useful when you return to your code months or years later so that you can remember what everything does without having to work it all out again. It's a good habit to get into if you're going to code as a job because quite often you'll be coding and passing it on to other people to use and maintain.
23rd Mar 2017, 9:39 PM
Shane
+ 4
null
24th Mar 2017, 8:51 AM
Irakli Samniashvili
Irakli Samniashvili - avatar
+ 4
Comments explaining the purpose of a method must always be there in a code, it makes much easier to understand when the code is being reviewed...
24th Mar 2017, 10:34 AM
Sowmya
Sowmya - avatar
+ 4
/* I comment were I thnk its necessary to comment otherwise I don't*/
24th Mar 2017, 1:42 PM
Geofrey Foya
Geofrey Foya - avatar
+ 4
Mostly little inline phrases for complicated/deep methods I may want to later modify/study; However I see how others use the ' //TODO: ' at the head of their comments; it is supported via third-party plugins— but that's a choice+
27th Nov 2017, 9:45 AM
Navardium
Navardium - avatar
+ 3
I add some comments to my HTML and CSS for sorting my elements and to help me find what i need to see and/or edit faster 🏃👍
23rd Mar 2017, 9:12 PM
Mouhammed Nashat Helmi
+ 3
sometimes, it helps to read and understand the code wich was written long ago
24th Mar 2017, 7:05 AM
Iryna Ivanytska
Iryna Ivanytska - avatar
+ 3
On important projects, all the time. I have a set of standards that I have set that I follow for important projects. Personal projects, or things that take me under 5 minutes to do, comments I don't do, as I feel like they waste my time. Perhaps a selfish thought but it is how the world wants us to work: fast, efficient, low cost.
24th Mar 2017, 1:41 PM
The Artist Formally Known as Jeremy
The Artist Formally Known as Jeremy - avatar
+ 3
Myself
27th Mar 2017, 7:33 AM
Vishnu ks
Vishnu ks - avatar