improved hit handling and added how-to helper text