refactor error handling

add trace field to picklers
rename trace to hint
add hints field to pickler
add documentation to PU type
fix some errors in the documentation