[Upg] improve docs