throw exception with message
better user docs, better error messages
updating branch