MINOR: cleanup top level class JavaDocs for main interfaces of Kafka …

…Streams DSL (3/N) (#18883)

Reviewers: Bill Bejeck <[email protected]>

streams/src/main/java/org/apache/kafka/streams/kstream/TimeWindowedCogroupedKStream.java

@@ -18,39 +18,16 @@
 
 import org.apache.kafka.common.utils.Bytes;
 import org.apache.kafka.streams.KafkaStreams;
-import org.apache.kafka.streams.KeyValue;
 import org.apache.kafka.streams.StoreQueryParameters;
 import org.apache.kafka.streams.StreamsConfig;
 import org.apache.kafka.streams.Topology;
 import org.apache.kafka.streams.state.ReadOnlyWindowStore;
 import org.apache.kafka.streams.state.TimestampedWindowStore;
 import org.apache.kafka.streams.state.WindowStore;
 
-import java.time.Duration;
 
 /**
- * {@code TimeWindowedCogroupKStream} is an abstraction of a <i>windowed</i> record stream of {@link KeyValue} pairs.
- * It is an intermediate representation of a {@link CogroupedKStream} in order to apply a windowed aggregation operation
- * on the original {@link KGroupedStream} records resulting in a windowed {@link KTable} (a <emph>windowed</emph>
- * {@code KTable} is a {@link KTable} with key type {@link Windowed Windowed<K>}).
- * <p>
- * The specified {@code windows} define either hopping time windows that can be overlapping or tumbling (c.f.
- * {@link TimeWindows}) or they define landmark windows (c.f. {@link UnlimitedWindows}).
- * <p>
- * The result is written into a local {@link WindowStore} (which is basically an ever-updating
- * materialized view) that can be queried using the name provided in the {@link Materialized} instance.
- * Furthermore, updates to the store are sent downstream into a windowed {@link KTable} changelog stream, where
- * "windowed" implies that the {@link KTable} key is a combined key of the original record key and a window ID.
- * New events are added to windows until their grace period ends (see {@link TimeWindows#ofSizeAndGrace(Duration, Duration)}).
- * <p>
- * A {@code TimeWindowedCogroupedKStream} must be obtained from a {@link CogroupedKStream} via
- * {@link CogroupedKStream#windowedBy(Windows)}.
- *
- * @param <K> Type of keys
- * @param <V> Type of values
- * @see KStream
- * @see KGroupedStream
- * @see CogroupedKStream
+ * Same as a {@link TimeWindowedKStream}, however, for multiple co-grouped {@link KStream KStreams}.
  */
 public interface TimeWindowedCogroupedKStream<K, V> {