Lots of new documentation
Some bad examples, fixt