[Upg] improve docs
Merge branch '1.1' into 1.2
Merge branch '1.2'