add documentation & simplify HighScores class
fix main class & add docs