Всем привет! Я с очередным вопросом-набросом. В сервисе используется какое-то ненулевое количество enum-значений. Они же фигурируют в документации (markdown). Хочется сделать так, чтобы менять эти списки нужно (а в идеале и можно) было бы только в одном месте, чтобы не терять синхронности между докой и кодом. Кто-то сталкивался с такой проблемой? Как решали?
Два очевидных решения - это или парсить код и вставлять результат в доку, или парсить доку и автогенерировать из неё код. Оба кажутся кривоватыми и ненадёжными.
Привет! Генерировать доку, но без необходимости парсить код. Например, имлементировать условный toMarkdown метод у енума и entrypoint который бы его вызывал. Если же в языке нет встроенной поддержки енумов, то смотрел бы в сторону решений похожих на //go:generate