[DOC] User feedback: Clarify which file is applied in procedures, plus style edits.

[d-laing]

Type of change

Select the type of your PR

• Documentation

Description

This pull request modifies three procedures to clarify which YAML file is applied.

• Kafka broker configuration
• Configuring authentication in Kafka brokers
• Changing the number of replicas
• Configuring Zookeeper

For each procedure, I modified the code samples to refer to _kafka.yaml_ instead of _my-file_. This is based on feedback from users.

I also took the opportunity to make some style edits across the procedures involved, and to the Kafka broker configuration assembly.

I changed the :ApacheKafkaBrokerConfig: attribute to refer to the latest Kafka documentation. I think we should make the same change to the other Kafka documentation link attributes.

Checklist

Please go through this checklist and make sure all applicable tasks have been done

• Update/write design documentation in ./design
• Write tests
• Make sure all tests pass
• Update documentation
• Check RBAC rights for Kubernetes / OpenShift roles
• Try your changes from Pod inside your Kubernetes and OpenShift cluster, not just locally
• Reference relevant issue(s) and close them after merging
• Update CHANGELOG.md

[PaulRMellor]

Looks good to me

[PaulRMellor]

Looks good to me