What kind of code documentation do you prefer?

Imagine that you have just joined a new organization and you are about to start working as a software developer. One of the existing team members comes up to you and introduces himself. He has with him a piece of paper with a complicated-looking diagram and a full binder that looks to be holding about 250 pages. He asks you, "you need to get up to speed quickly on our existing system - we're starting you coding tomorrow - would you prefer to go over the architecture diagram with me or would you prefer to review the detailed specifications and design documents." He indicates the one-page diagram and the binder respectively.

* 1. Which would you prefer?

Report a problem

T