9
eo2875
4y

/* JavaDoc above */
def inconsistentComments(){
""" Python docstrings below """
}

Comments
  • 0
    😂
  • 3
    when it's longer than one line, explaining more than the following line, or explaining what the following line does, then above.

    when it's a bit of additional info for the line of code, then next to it:

    position += orientation * speed * deltaTime; //deltaTime to make it go brrr framerate-independently
  • 1
    Comments are always above or inline. Documentation blocks vary in languages but are generally above the definition.
    Perl POD is often below all the code.
  • 1
    Actually would be interested what you comment?
    😅
  • 1
    `def inconsistentComments() {
    ...
    }`

    o.o what language is this? Some kind of Python hybrid with a C-like?
Add Comment