Updated documentation (mostly typos, style, some clarifications, added a few FAQ-examples)