add doc section on error handling
change set example to show binary type