Ebook: A Philosophy of Software Design

The nature of complexity -- Working code isn't enough -- Modules should be deep -- Information hiding (and leakage) -- General-purpose modules are deeper -- Different layer, different abstraction -- Pull complexity downwards -- Better together or better apart? -- Define errors out of existence -- Design it twice -- Why write comments? The four excuses -- Comments should describe things that aren't obvious from the code -- Choosing names -- Write the comments first -- Modifying existing code -- Consistency -- Code should be obvious -- Software trends -- Designing for performance.