reworded and rephrased stuff
a bazillion changes
transmogrifies the real world (ls) example and the summary
minor rephrase
better title (?) and a TODO