add errors implementation
add examples
add debugging aid
add debugging example