add comments of sample usage for existing game API endpoints (fixes #285)