fix example code, add links, general formatting