[jhoechtl]

Very true. Good examples consume a lot of time. I was bitten a couple of times when the customer nailed me down with "But this example can never occur" and my futile attempt to justify "But it's an example!"

Good examples make documentation worthwhile to read.

Good defaults make an application worthwhile to use.