When to go to Redpanda docs vs. Kafka docs?

[danthegoodman1]

For example, I could barely find are reference to topic level retention settings (retention.ms) in Redpanda, and am assuming the Kafka docs will suffice.

It would be nice if there was a suggestion in the docs on when to look to Kafka docs.

[emaxerrno]

@danthegoodman1 - good point, i think this is a gap in our docs. For the settings we provide, we should have a link that says we support the same, but we should also have a section that says what each setting does. by and large, we work very hard to be compatible with upstream to lessen the cognitive dissonance, but we should fix.

Feel free to open any tix here.

[danthegoodman1]

Also a notable difference between Redpanda and Kafka is the settings for the default retention settings. They are named slightly differently (delete_retention_ms in Redpanda vs. log.retention.ms in Kafka) and I am assuming the difference here is due to how Redpanda handles compaction differently? Or maybe they aren't the same, not sure.

[danthegoodman1]

I'm sorry, it seems the Kafka version is log.cleaner.delete.retention.ms with delete.retention.ms being the topic level control. Still unsure what the Redpanda equivalent would be, if there is a log level retention setting rather than just the compacted segment setting.

[danthegoodman1]

Btw this was the one reference I found to retention.ms: #689 (comment)

[emaxerrno]

@coral-waters ^^ we should have all kafka settings that make sense also on our docs

[coral-waters]

Fyi, I created a doc ticket for this. Thanks for the feedback.
https://github.com/vectorizedio/documentation/issues/62