Хочу вести документацию, держать документацию и код связанными, зафиксировать называния (общий язык)
Для этого хочу сделать интерфейсы для задокументированного кода (сущности, основные сервисы, все такое).
На основе этих интерфейсов генерить часть документации. Остальная документация должна ссылаться на эти сгенеренные вещи, чтобы все было связано и не распадалось. Так же надо как то проверять, все ли связано, целостность, так сказать. Нужны ссылки внутри документа (на термины), в том числе, чтобы обратно можно было попасть
Хочется это все хранить в гите, в текстовом или около того виде, чтобы видно было дифф.
Надо чтоб это открывалось и на винде и на линуксе. И в идеале чтобы потом в браузере можно было отрендерить.
(Я вообще уже к html/js склоняюсь...)