Hey,

I was surprised to discover that MirrorMaker 2.0 (part of 2.4
release), is not mentioned at all in our documentation
(https://kafka.apache.org/documentation/).

Ryanne Dolan was kind enough to point me to the documentation for this
feature (https://github.com/apache/kafka/blob/trunk/connect/mirror/README.md)
and mentioned that the Operations docs will be updated when MM1 is
deprecated.

IMO, this is a disservice to our users. If we already know that we
plan to deprecate MirrorMaker and replace it, we need to let users
know that an alternative exists, that they should start planning a
transition and how to use the cool new feature. And we need to do it
in the place where our users normally go to learn how to use our
product.

As it stands now, the README doesn't even show up on Google search
results, so discovering how to use MirrorMaker 2.0 is nearly
impossible. How can we expect to deprecate 1.0 if users can't find out
about 2.0?

In the past, we've documented new features before existing features
were deprecated (--broker-list and --bootstrap were documented before
--zookeeper was removed). I suggest we'll stick to this precedent.

Gwen

Reply via email to