improved examples and info

closes #2, #3, #4