davidradl commented on code in PR #27201:
URL: https://github.com/apache/flink/pull/27201#discussion_r2498286879
##########
docs/content/docs/dev/datastream/operators/overview.md:
##########
@@ -700,12 +700,12 @@ some_stream.filter(...).name("filter").set_description("x
in (1, 2, 3, 4) and y
{{< /tab >}}
{{< /tabs>}}
-The format of description of a job vertex is a tree format string by default.
-Users can set `pipeline.vertex-description-mode` to `CASCADING`, if they want
to set description to be the cascading format as in former versions.
+Depending on your needs, you may want to modify some of the default naming
behaviors for vertices and operators.
-Operators generated by Flink SQL will have a name consisted by type of
operator and id, and a detailed description, by default.
-Users can set `table.exec.simplify-operator-name-enabled` to `false`, if they
want to set name to be the detailed description as in former versions.
+By default, the description of a job vertex is organized in a multi-tree line
mode.
+To use a single line cascading mode, set `pipeline.vertex-description-mode` to
`CASCADING`
-When the topology of the pipeline is complex, users can add a topological
index in the name of vertex by set `pipeline.vertex-name-include-index-prefix`
to `true`,
-so that we can easily find the vertex in the graph according to logs or
metrics tags.
+By default, operators generated by Flink SQL will have a name composed of the
operator type and id. Details will remain in the description.
+To include the description, set `table.exec.simplify-operator-name-enabled` to
`false`
Review Comment:
I would think `table.exec.simplify-operator-name-enabled`
true : would mean a simplified name with more details in the description.
false: would mean a more complicated name including elements of the
description. Does this mean there is no description?
I am not sure this sentence is saying that. Did I understand correctly?
--
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.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
