add documentation
add explicit runtime exceptions when the examples don't work as I expect
documentation change, better text output in example 1