Improved documentation about zh-* deprecation and upgrade path