added examples and error catch-ups to README