+ 14

What level of commenting code is right for learning?

Comment main method? All helper methods? EOL for tricky statements? other thoughts?

21st Apr 2017, 11:42 AM
‎‏‎‏‎Joe
‎‏‎‏‎Joe - avatar
5 Antworten
+ 5
Indeed comments in the code increases the readability of code, but at the same time excessive comments can make a good code complicated. More on comments, visit following link https://code.tutsplus.com/tutorials/top-15-best-practices-for-writing-super-readable-code--net-8118
21st Apr 2017, 11:55 AM
à€Šà„‡à€”à„‡à€‚à€Šà„à€° à€źà€čà€Ÿà€œà€š (Devender)
à€Šà„‡à€”à„‡à€‚à€Šà„à€° à€źà€čà€Ÿà€œà€š (Devender) - avatar
+ 13
ty everyone here helpful for SL and classroom.
26th Apr 2017, 2:54 PM
‎‏‎‏‎Joe
‎‏‎‏‎Joe - avatar
+ 6
documentation is verry important, there cant be enough, when I look back to my old codes its like an textbook and I can remember why did I took that step exactly. The idea is read once understand all, if you cant apply that, do more documentation â˜ș👍 thumb rule : Documentation : Code 0 : 1 - > use documentation omg! 1 : 1 - > great 2 : 1 - > ok 3 : 1 - > if it gets complicated you dont need to comment every line, you can also work on sections and use up to 3 lines of documentation for a code segment , but keep in mind you have to remember after 3 weeks what was your thought on this part. Remember: read once understand all
25th Apr 2017, 2:03 AM
Moersy
Moersy - avatar
+ 3
Comments and hierarchical flow of program helps us for following 1. For future reference 2. For Documentation 3. Understood by the Lay man 4. Updating codes in future. 5. Helping tester team to understand it.
26th Apr 2017, 5:42 AM
BASKARAN C
BASKARAN C - avatar
+ 2
Your code should be able to speak for itself, but meaningful comments might add clarity
24th Apr 2017, 1:38 AM
Seth Tenembaum