updated docs, better examples, changelog->NEWS