Should I use comments in code, liberally?

Question

Everything,

Comment liberally or not? Pros and cons. I personally prefer to comment, because it leaves nothing for the fantasies of people reading it.

thanks

Answer 1

Jeff Atwood: No Comment Coding

Answer 2

In my experience, people who think their code is commenting is invariably wrong. You may remember why you did something in a certain way when you revise the code, but someone else who supports it will not.

If you need to do some research to write a piece of code, include a link or a note.

- , , , - .

, , ,

Answer 3

" ". , , , , , .

, , , , , , , , , . , , , , , .

Answer 4

, (a) (b) , , .

, , , .

, , .

Answer 5

, .

, :

:

• , , , .

• , , , , , .

• , - , , , , .

• , , , .

, :

• , , .

• , .

, , , . , , .

Answer 6

, , . , , . , , . , - .

.

//Copies a record 
//This function will copy the Src Record to the Dest Record 
void CopyRecord(Record *Dest,const Record *Src);

, - c ,

//
//This function will perform a shallow copy from the src record to the dest record 
//Dest pointer  must be null and allocation will occur inside function 
void CopyRecord(Record *Dest,const Record *Src);

, , , .

Answer 7

, . , , .

Answer 8

:

:

• ,
• , .
• , , , .
• , , , , .

Answer 9

, , , .

Answer 10

, O'Reilly 97 , (. Coders at Work).

,

Answer 11

, , , , , . , , . .

Answer 12

, , . , , , .

, CS , , , . " " , , , , .

, , . , . script, , , .

Answer 13

, , .

-, , . , . , . on-line, .

-, . , , , , , , . ( , , , , , .)

-, , , . , , - . , , , ( ), . , , .

, , . , , , . , .

Answer 14

: "". , / , , , . , , , .

Answer 15

:

• . , , , , .
• -

Answer 16

( , ), , , . .: -)

, , . ( . , ?) , , "" (, , , ..)