moar examples and links and typos