Tagged Questions
17
votes
10answers
1k views
Are chatty/humorous comments in source code acceptable or unprofessional? [duplicate]
Possible Duplicate:
Humor in Documentation
Throughout my professional career, I have often relied on chatty or humorous comments in source code (or source control commit messages) to help ...
8
votes
11answers
1k views
Version control comments - past or present tense
For version control comments what do other users do/recommend - past or present tense?
I.e.
Changed x to be y.
or
Changing x to be y.
3
votes
3answers
127 views
Is there a difference between the quotes in `help',``help“, 'help' and ”help"?
Sometimes I find in the source code files comments have quotation marks like these ,notice the ` :
`help'
``help"
For example, these are comments from GNU cat source code file, cat.c:
/* Plain ...
1
vote
7answers
438 views
Shouldn't we count characters of code and comments instead of lines of code and comments? [closed]
Counting lines of code and comments is sometimes bogus, since most of what we write may be written in one or more lines, depending column count limitations, screen size, style and so forth.
Since the ...
1
vote
4answers
136 views
Deciphering foreign code
What is the best strategy to go about understanding some one else's code for a medium sized project, if the code is not well documented and does not adhere to many coding standards?
