Print

Please login or register.
1 Hour 1 Day 1 Week 1 Month Forever
Login with username, password and session length

[LordSlowpoke]

do you not understand the concept of commenting your code or is that for some godawful reason impossible in your circumstance

[hops]

Commenting on code? Are you kidding me LSP?

Next you'll tell people to work in orderly and efficient manner.

[Orange Wizard]

do you not understand the concept of commenting your code or is that for some godawful reason impossible in your circumstance

I think he means the output is unreadable.

I never comment my code, actually. It leads to fun and interesting surprises, especially in large projects.

[EnigmaticHat]

do you not understand the concept of commenting your code or is that for some godawful reason impossible in your circumstance

While I am a programming n00b, my understanding is that comments are mainly for coming back to code after its done, or understanding code written by someone else.  They're not much help when you're just setting out to write something, because at that point you can probably keep in your head what you want to happen (or write it down in pseudocode if its really long).

[Skyrunner]

// Implements Rodrigue's rotation formula.
function rotateVector(rotated, rotation) {
    var angle = rotation.getLength();
    var k = new Vector3(rotation.xyz).normalize(); // get the unit vector that represents the axis to be rotated around.
    var temp1 = rotated.multiply(Math.cos(angle));
    var temp2 = k.cross(rotated).multiplyBy(Math.sin(angle));
    var temp3 = k.multiply(k.dot(rotated) * (1 - Math.cos(angle)));
    temp1.addBy(temp2).addBy(temp3);
    return new Vector3(temp1.xyz);
}

Those are my comments. I might write a line about what a part of the code does. Without the comments. it's pretty hard to tell what the heck k.cross(rotated).multiplyBy(Math.sin(angle)) is supposed to be, but with the context you can tell it just implements Rodrigue's rotation formula.

[BFEL]

Commenting is the concept of including "comments" in your code that have...usually I think hashtags are used(??) but anyway you do that so that the computer doesn't actually read it like a command, but you can look at it to see what something does or somesuch.

[miauw62]

Commenting code doesn't automatically make it expandable.

I generally just add jokes here and there though.

Things like

Code: [Select]

   //Hot simple_animal baby making vars
   var/childtype = null
   var/scan_ready = 1
   var/species //Sorry, no spider+corgi buttbabies.
Python uses hashtags, but I *think* most languages use // to indicate a comment (and /* with */ to indicate multi-line and inline comments). In python // is used for truncated division or whatever you're supposed to call it.

[Skyrunner]

You can kinda use triple quotes for multi-line comments!

[Orange Wizard]

Python uses hashtags, but I *think* most languages use // to indicate a comment (and /* with */ to indicate multi-line and inline comments). In python // is used for truncated division or whatever you're supposed to call it.

Floor division.

You can kinda use triple quotes for multi-line comments!

Kinda! It seems to work fine, though!

[Darvi]

I never comment whenever it's not required. When the only things you code is for assignments, you generally don't get to write stuff that isn't immediately evident in what it's doing.

[scriver]

And when you don't code for assignments, it's important to remember to not leave too many comments as to not inadvertently causing it to make sense to whatever poor fool happens upon it.

[Lightningfalcon]

Normally I don't comment.  When I do comment, however, it is after coming back to a project several months later, and I'm commenting just to try to figure out what is going on in my code.

[miauw62]

The code for /tg/station has so many layered comments that look a bit like this:

Code: [Select]

O:mind:name //Get the name //WHY WOULD YOU DO THIS //wtf //TODO: remove this //lol oldcode //It is the 41st millenium. For more than a hundred centuries this has gone unfixed.
etc etc.

[Shakerag]

I want to smack the lot of you around for talking about not commenting code  >_<

Of course, way back in my day, when I was in college and learning assembler, the program we were using wouldn't even compile your code unless something like at least 95% of your lines had a comment on them. 

Makes you get into the habit. 

[Akura]

Nearly broke my multitool trying to tighten the screws for my basket mount, or whatever the hell it's called. Then, halfway to the library, I discovered that my stepdad hasn't been keeping up with cleaning the yard up after his dogs. And when I got to the library, I manage to dislodge one of the zip ties keeping the basket(actually a milk crate) on the mount, as said zip ties do not stay put.