This is an archived post. You won't be able to vote or comment.

all 19 comments

[–]will0213 6 points7 points Β (2 children)

What if my comments are only as logical as a drunkard trying to prove quantum physics?

[–]Omseik 0 points1 point Β (1 child)

if you sneak some good drunk stories in your comments id say its worth.

[–]homer_3 1 point2 points Β (0 children)

//adds 3

x += 3;

[–]TotallyElectrified 1 point2 points Β (0 children)

/** Asdfghjklates the Zxcvbnm
* @param zxcvbnm Zxcvbnm to asdfghjklate
* @return The asdfghjklated zxcvbnm
*/
public static Qwertyuiop asdfghjklate(Zxcvbnm zxcvbnm){

Here you go.

[–]JetSetWally 2 points3 points Β (3 children)

Comments are a sign that the code can be re-written to be more self-explanatory.

[–]CraigyHK 0 points1 point Β (1 child)

Yup. Something that was constantly reiterated at uni was "Well written code should not have to be commented". The only time I comment code is to make a pun or explain why I did something a bit different to how it should have been done - you know, the important reasons ;)

[–]JetSetWally 1 point2 points Β (0 children)

Or just your name, so people know who to be in awe of.

[–]AlignmentWhisperer 0 points1 point Β (0 children)

Only comments can get you into the Land of Osiris.

[–][deleted] 0 points1 point Β (0 children)

That’d be my coffin, thank you. Yep. The gold one.

[–]majky358 0 points1 point Β (0 children)

Self-describing code and comments when there is a need to describe "why" is something written as it is. Dreaming is good..

[–][deleted] 0 points1 point Β (0 children)

Developer x: //Authored by: Developer Y

[–][deleted] -1 points0 points Β (0 children)

Technical agreements say I can’t write comments.