Schreib's unterhaltsam. Lange Texte sind ermüdend, wenn sie dem Leser keine Freude bereiten. Andererseits kann ein interessant gestalteter Text dem Leser mehr vermitteln, wenn er ihn dazu anregt, sich mit dem Thema zu befassen. Why's (Poignant) Guide to Ruby ist ein gutes Beispiel. Unterhaltsam und lehrreich.