[ 
https://issues.apache.org/jira/browse/KAFKA-15307?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=18014057#comment-18014057
 ] 

Matthias J. Sax commented on KAFKA-15307:
-----------------------------------------

Thanks [~shashankhs] – made a pass over your PR.

For 4.1.0 changes, let's add them to your open PR. Yes, we should mark both 
config as deprecated (no need to mention the version IMHO – we don't mention 
the version for other deprecated configs either, and consistency is kinda 
important). – For pointing to the new config, it's a little bit more 
complicated, as the config moves out `StreamsConfig` and thus it does not seem 
to be appropriate to have it in this page? Maybe we should extend 
[https://kafka.apache.org/documentation/streams/developer-guide/datatypes.html] 
and add a whole new section about _all_ window-serdes (these are missing the 
doc entirely atm), and just add a link to the deprecated configs into the new 
section?

> Kafka Streams configuration docs outdated
> -----------------------------------------
>
>                 Key: KAFKA-15307
>                 URL: https://issues.apache.org/jira/browse/KAFKA-15307
>             Project: Kafka
>          Issue Type: Task
>          Components: docs, streams
>            Reporter: Matthias J. Sax
>            Assignee: Shashank
>            Priority: Major
>              Labels: beginner, newbie
>
> [https://kafka.apache.org/35/documentation/streams/developer-guide/config-streams.html]
>  need to be updated.
> It's missing a lot of newly added config, and still lists already removed 
> configs.
> For deprecated configs, we could consider to also remove them, or add a 
> "deprecated config" section and keep the for the time being.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

Reply via email to