Коллеги, всем привет!
А есть у кого-то налаженный процесс документации отчетов? Как для пользователя, так и для разработчиков, которым может отчет достаться "по наследству"?
Я пока описание логики расчета неочевидных метрик привожу в виде подсказок прямо в отчете (для пользователя), а для разработчиков - в конфлюенс, но пока мой шаблон частенько правится. Может кто-то уже выработал удобный шаблон документации, где описаны и особенности SQL-запросов (зачем нужны какие-то неочевидные преобразования, которые вызваны особенностями источника данных, например, какие-нибудь косяки), и предназначение фильтров на стороне источников и т.д.) Хочется по максимуму уменьшить боль разработчика, который будет разбираться в отчете (или для себя же, когда вернешься к доработке отчета спустя длительное время и забудешь о всех возможных "сюрпризах")