Should one programmer document other code?

Question

Some of our lead developers chased the manual to appoint a junior developer to document their code for them.

Their arguments are:

• You will have two programmers familiar with everything.
• This is a couple programming, kinda.
• This is more cost effective = they will do more.
• It demonstrates that their code is readable and supported.
• They will be happy to answer any questions; so this is a form of mentoring.

However, the number of programmers that they continue to be busy to stay up to date increases with time.

Is that a good idea?

---

Wow! This is not our experience!

Here are some clarifications that will prove important.

• - . . " ".

• ( , , ).

• , . , .

• , , , . , YAGNI, .. . , . ( , . - , , - , .)

• ?

• Agile " ". , .

, - , , , , . ?

, , , . . ( 3 .)

Answer 1

, . :

• , , "" . . .

• , ? , , , .

• - , , , . . , . , , .

• "". , Javadoc .., , ( ..). , .

• " " . 5 5 , 5 , . 10 2/3, (~ 6 ).

Answer 2

. - , , - , .

, .

. , 6 , , , ( ) .

, . , - . , .

Answer 3

,

, , , .

, .

Answer 4

!! , , , ?

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

? SQA?

Answer 5

- , , , / . , , . , . , - - - .

, - , , , "" . , , , , .

Answer 6

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

, . , , .

Answer 7

. . , , . - , . , , .

Answer 8

, , :

Joel :

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

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

Yegge :

UW, , , Intel, , . , , Intel " ". , 5 6 , , ; TPS, . , , .

, , , , , - . , . . . UW, , , CS Intel. Intel - , .

, , ... . , , , .

, , /, Google, , , , . ( -, .) , Google, , .

Answer 9

, , .

Answer 10

, -, . , :

• , ? , , , , .
• ? , , , .

Answer 11

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