version bump and exceptions documented