Myths Open Source Developers Tell Ourselves
Subject:   on code reading
Date:   2003-12-12 11:54:06
From:   chromatic
Response to: on code reading

I'm not sure where you picked up the idea that I don't recommend reading code. One of the persistent problems in software development today is that far too few people DO read code.

That said, the myth is that pointing at a huge pile of code and telling new developers "just read it" is effective. I think that's possibly the least effective way to learn a project.

There's no substitute for reading code. I certainly don't intend to give that impression. At some point, new developers absolutely must read the code.

I don't think that's the best, first place to start though. Show them a glossary, an overview, completed story cards, or maybe UML. Explain how the pieces fit together. Then (and only then) let them examine the individual pieces.

1 to 3 of 3
  1. on code reading
    2003-12-16 13:00:49  theoldmoose [View]

  2. on code reading
    2003-12-14 03:33:14  anonymous2 [View]

  3. on code reading
    2003-12-12 12:44:57  anonymous2 [View]

1 to 3 of 3