Thesharing commented on a change in pull request #13172:
URL: https://github.com/apache/flink/pull/13172#discussion_r475318732
##########
File path: docs/dev/migration.zh.md
##########
@@ -25,18 +25,18 @@ under the License.
* This will be replaced by the TOC
{:toc}
-See the [older migration
-guide](https://ci.apache.org/projects/flink/flink-docs-release-1.10/dev/migration.html)
-for information about migrating from older versions than Flink 1.3.
+有关从 Flink 1.3
之前的旧版本进行迁移的信息，请参阅[旧的迁移指南](https://ci.apache.org/projects/flink/flink-docs-release-1.10/dev/migration.html)。
-## Migrating from Flink 1.3+ to Flink 1.7
+<a name="migrating-from-flink-13-to-flink-17"></a>
-### API changes for serializer snapshots
+## 从 Flink 1.3+ 迁移到 Flink 1.7
-This would be relevant mostly for users implementing custom `TypeSerializer`s
for their state.
+<a name="api-changes-for-serializer-snapshots"></a>
-The old `TypeSerializerConfigSnapshot` abstraction is now deprecated, and will
be fully removed in the future
-in favor of the new `TypeSerializerSnapshot`. For details and guides on how to
migrate, please see
-[Migrating from deprecated serializer snapshot APIs before Flink 1.7]({{
site.baseurl
}}/dev/stream/state/custom_serialization.html#migrating-from-deprecated-serializer-snapshot-apis-before-flink-17).
+### Serializer snapshots 的 API 变更
+
+这主要与为其状态实现自定义 `TypeSerializer`s 的用户相关。
+
+现在已弃用旧的 `TypeSerializerConfigSnapshot` 抽象，并在将来完全删除，以使用新的
`TypeSerializerSnapshot`。有关如何迁移的详细信息和指南，请参阅[从 Flink 1.7 之前弃用的 serializer
snapshot APIs 迁移]({% link dev/stream/state/custom_serialization.zh.md
%}#migrating-from-deprecated-serializer-snapshot-apis-before-flink-17).
Review comment:
I wonder would it be better to say the first sentence like "目前已弃用旧的
`TypeSerializerConfigSnapshot` 抽象类，之后将以新的 `TypeSerializerSnapshot` 接口取而代之。",
and I think it would sounds better if we say "从 Flink 1.7之前的版本所使用的 serializer
snapshot API 迁移到新版本".
##########
File path: docs/dev/migration.zh.md
##########
@@ -25,18 +25,18 @@ under the License.
* This will be replaced by the TOC
{:toc}
-See the [older migration
-guide](https://ci.apache.org/projects/flink/flink-docs-release-1.10/dev/migration.html)
-for information about migrating from older versions than Flink 1.3.
+有关从 Flink 1.3
之前的旧版本进行迁移的信息，请参阅[旧的迁移指南](https://ci.apache.org/projects/flink/flink-docs-release-1.10/dev/migration.html)。
Review comment:
I'd like to propose "旧版本迁移指南" instead of "旧的迁移指南".
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
