Improved documentation about zh-* deprecation and upgrade path. Thanks to Baptiste Mispelon for the code reviews.