global docs refactor