The current documentation sometimes assumes default instance names, and sometimes overrides the default, so commands in the docs don't work when copied verbatim.
For example the installation docs for Kafka override the names with --instance, but Kafka tries to connect to a ZooKeeper named zookeeper-instance, so it never comes up.
In another example, the docs for scaling Kafka sometimes assume the default instance name, and sometimes it is overridden.
My recommendation is to use the default instance names in the docs to keep things simple, and assume default instance names in parameter such as the ZooKeeper host names. I'm happy to make a pass if people agree but wanted to post this first to see if work is already underway.
The current documentation sometimes assumes default instance names, and sometimes overrides the default, so commands in the docs don't work when copied verbatim.
For example the installation docs for Kafka override the names with
--instance, but Kafka tries to connect to a ZooKeeper namedzookeeper-instance, so it never comes up.In another example, the docs for scaling Kafka sometimes assume the default instance name, and sometimes it is overridden.
My recommendation is to use the default instance names in the docs to keep things simple, and assume default instance names in parameter such as the ZooKeeper host names. I'm happy to make a pass if people agree but wanted to post this first to see if work is already underway.