Improving Examples and Documentation

[ingo]

> I don't know where this aversion to writing documentation comes from.

"Read the source, Luke!".

:(