cleanup and comments in examples
linked examples