opened
PaulRMellor
username_0
**Documentation**

New section for the _Using_ guide that provides tips on tuning broker configuration

Includes new diagrams that will be refined and standardized after review.

### Checklist

_Please go through this checklist and make sure all applicable tasks have been done_

- [ ] 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
- [ ] Supply screenshots for visual changes, such as Grafana dashboards
[DOC] broker tuning
issue
created
PaulRMellor
username_0
Right. Well, we're reusing this content in the RHEL doc too, so probably best to keep the `=`. The headers I can change to [source, env]
comment
created
scholzj
username_1
Not sure how confusing it will be for users - but I guess in the worst case they will get an error when creating the resource. And so far IMHO nobody complained. So I'm fine to keep the examples as they are and fix the headers.
comment
created
PaulRMellor
username_0
@tombentley Thanks for the latest comments. I've left a couple unresolved, which you might want to check. 
I've also rearranged the sections on _Managing logs with data retention policies_ and _Removing log data with cleanup policies_, with additions like using topic-level cleanup policy and _tombstones_.
comment
created
PaulRMellor
username_0
@LiamClarkeNZ  has no further comments to add.
comment