rename variables for safety
documentation updates