В моём опыте работы с Kafka я занимался описанием архитектуры обмена сообщениями между микросервисами. Основные моменты, которые я документировал:

Структура топиков: какие топики используются, их назначение и схема сообщений.
Конфигурация продюсеров и консьюмеров: настройки партиционирования, уровни подтверждения доставки (acks), обработка ошибок.
Механизмы обеспечения гарантированной доставки и обработки дубликатов.
Мониторинг и алертинг: какие метрики собираются, как отслеживается состояние брокеров и задержки.
Политики ретенции данных и очистки топиков.

Например, я описывал сценарии, когда сервисы публикуют события о заказах, а другие сервисы подписываются на эти события для обновления своих данных. В документации приводились примеры форматов сообщений в JSON, а также рекомендации по обработке ошибок и повторным попыткам.

Расскажите про опыт работы с Kafka — что именно описывали?