updated usage examples, testing notes, more links