updated global docs