review comments

mjsax · mjsax · commit bf3099cd05bd · 2025-02-06T11:49:29.000-08:00
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
@@ -2403,8 +2403,9 @@ <VT, VR> KStream<K, VR> leftJoin(final KTable<K, VT> table,
      *
      * In contrast to {@link #join(KTable, ValueJoiner)}, there is no co-partitioning requirement between this
      * {@code KStream} and the {@link GlobalKTable}.
-     * Also note, that the {@link GlobalKTable} is updated "asynchronously", and thus this operation is inherently
-     * non-deterministic.
+     * Also note that there are no ordering guarantees between the updates on the left and the right side of this join,
+     * since updates to the {@link GlobalKTable} are in no way synchronized.
+     * Therefore, the result of the join is inherently non-deterministic.
      *
      * @param globalTable
      *        the {@link GlobalKTable} to be joined with this stream

Original file line number	Diff line number	Diff line change
`@@ -2403,8 +2403,9 @@ <VT, VR> KStream<K, VR> leftJoin(final KTable<K, VT> table,`
`2403`	`2403`	`*`
`2404`	`2404`	`* In contrast to {@link #join(KTable, ValueJoiner)}, there is no co-partitioning requirement between this`
`2405`	`2405`	`* {@code KStream} and the {@link GlobalKTable}.`
`2406`		`- * Also note, that the {@link GlobalKTable} is updated "asynchronously", and thus this operation is inherently`
`2407`		`- * non-deterministic.`
	`2406`	`+ * Also note that there are no ordering guarantees between the updates on the left and the right side of this join,`
	`2407`	`+ * since updates to the {@link GlobalKTable} are in no way synchronized.`
	`2408`	`+ * Therefore, the result of the join is inherently non-deterministic.`
`2408`	`2409`	`*`
`2409`	`2410`	`* @param globalTable`
`2410`	`2411`	`* the {@link GlobalKTable} to be joined with this stream`