[increment][docs] grooming git hook error handling, plus docs