refine "on_error" attribute documentation
document :take and :discard attributes