added comments to world.js methods