hangman: Added phpDoc, small fixes, code review