fixes, documenttation and tests for game api