#11: cleanup error handling in Id and make changes to scaladoc