refactor and improve JavaDoc for action events