Darrel Norton links to Jack Reeves' classic article on the essence of software design. The part that especially rings a bell with me is when Jack writes
... the only software documentation that actually seems to satisfy the criteria of an engineering design is the source code listings.
That should also ring a bell with you if you've participated one of my trainings on refactoring, XP, or object-oriented design in general. In all of these trainings, I like to discuss about what is good code and what is good design. That quote is a nice little pepper to spice up the conversations. Another good one is a quote from Bob Martin's ASD book.
I'll post that other quote later -- I suddenly have to run...
UPDATE: Here's the Uncle Bob quote:
The design of a software project is an abstract concept. It has to do with the overall shape and structure of the program as well as the detailed shape and structure of each module, class and method. It can be represented by many different media, but its final embodiment is source code. In the end, the source code is the design.







