Update comments in RSHighscores.php to reflect changes in api

@Grunny just some comment changes as discussed on skype. There's ticket for this at MAIN-2754 for the sake of a paper trail too