ML
Я хотел связать документацию к кода и документацию бизнеса
а ты хочешь поиграться в песочке и изучить что то новое или сделать инструмент для бизнеса?
Size: a a a
2020 May 14
LS
а ты хочешь поиграться в песочке и изучить что то новое или сделать инструмент для бизнеса?
Я хочу найти готовый инструмент
ML
В моём понимании, для норм документации хватит и md файлов, главное – чтобы её писали и поддерживали. Тут не с тулзами нужно играть а людей муштровать и процессы настраивать. А там, как начнуть в промышленных масштабах генерировать документацию, начнутся конкретные проблемы, к которым можно будет найти конкретное решение
LS
Людей муштровать....
LS
Это все равно приведет к ошибкам
ML
Это все равно приведет к ошибкам
?
LS
Ручная работа приведет к ошибкам
AD
Ручная работа приведет к ошибкам
ну а как можно доку генерить?
описание API какого-то - да, но если много описаний логики - никак
описание API какого-то - да, но если много описаний логики - никак
LS
Мне хотя бы базовые классы загенерить - уже полдела будет готово. А логику текстом в коментах опишу, норм
AM
Мне хотя бы базовые классы загенерить - уже полдела будет готово. А логику текстом в коментах опишу, норм
Так эцсамое, dokka, не?
AN
Мне хотя бы базовые классы загенерить - уже полдела будет готово. А логику текстом в коментах опишу, норм
А чем тебя dokka не устраивает для классов?
LS
Хм... не смотрел. А что она сгенерит?
AN
Там и линки все автоматом
AM
Док-комменты прям в коде, докка дальше это в хтмл сгрести может. Плюс она позволяет в свободной форме мд-шки добавлять к коду, они тоже в хтмл поедут.
LS
А, вижу
AN
Хм... не смотрел. А что она сгенерит?
Блин, я думал ты в курсе и хочешь странного
AM
Там, правда, были какие-то решаемые траблы с мультиплатформой, т.е. наладить её может оказаться нетривиально
LS
Ну... вот тут начинается немного странное
LS
я бы хотел чтобы по клику по свойству можно было посмотреть где оно используется
AN
я бы хотел чтобы по клику по свойству можно было посмотреть где оно используется
Да,все есть