MINOR: cleanup KStream JavaDocs (7/N) - repartition/to/toTable

[mjsax]

No description provided.

[lucasbru]

Thanks! I left some comments

[lucasbru]

Suggested change

	* All topics should be manually created before they are use (i.e., before the Kafka Streams application is started).
	* All topics should be manually created before they are used (i.e., before the Kafka Streams application is started).

[lucasbru]

The parameter produced is not explained anywhere now. Same for the other methods. Would it make sense to refer from most generic to the most specific overload instead?

[mjsax]

It's covered above on to(String) as well as to(TopicNameExtractor):

<p>To explicitly set key/value serdes or the partitioning strategy, use {@link #to(String, Produced)}.

Not sufficient, or did you miss it?

Would it make sense to refer from most generic to the most specific overload instead?

I did consider this originally, but found if overall more complicated than helpful, and though it's easier to describe the most simple overload and just add "forward reference" (as quoted above, and used elsewhere) instead.

[lucasbru]

I'm not aware of this syntax. Do you know / have you checked that it works?

[mjsax]

I did not intent to make it syntax, but just regular text with a link... If that's confusing, happy to change it.

[lucasbru]

LGTM, thanks!

[chia7712]

This PR is great and has given me an idea for improving our CI process.

This PR introduce a java doc error, and hence QA does not run streams:test.

2025-02-05T05:09:25.4676334Z /home/runner/work/kafka/kafka/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java:694: warning: invalid usage of tag {@link #to(String).
2025-02-05T05:09:25.4677773Z 
2025-02-05T05:09:25.4692001Z      * See {@link #to(String).}
2025-02-05T05:09:25.4692476Z > Task :streams:javadoc FAILED
2025-02-05T05:09:25.4693167Z            ^
2025-02-05T05:09:25.4694441Z /home/runner/work/kafka/kafka/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java:694: warning: invalid usage of tag {@link #to(String).
2025-02-05T05:09:25.4695730Z      * See {@link #to(String).}
2025-02-05T05:09:25.4696252Z            ^
2025-02-05T05:09:25.4697406Z /home/runner/work/kafka/kafka/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java:694: warning: invalid usage of tag {@link #to(String).
2025-02-05T05:09:25.4698737Z      * See {@link #to(String).}
2025-02-05T05:09:25.4699299Z            ^

By contrast, quarantinedTest is still executable because quarantinedTest does not depend on javadoc

https://github.com/apache/kafka/blob/trunk/build.gradle#L710

Although #18838 resolves the current doc error, I believe we should enhance our CI to prevent similar issues from occurring in the future. To be honest, it is too hard to request reviewers to check all contents of CI. Maybe we can add javadoc to the build phase which is similar to #18183. @mumrah WDYT?

[mjsax]

Thanks for highlighting this issue (and thanks for the PR to fix it). The build for this PR did not surface this issue (otherwise we would not have merged it). I agree, that it might be good to fail PR builds if there is JavaDocs errors.