АК
@NortaBirdo автоматизировал документирование баз данных, может знать
Спасибо!
Size: a a a
2019 January 08
Н
Правда есть проблемка - там нельзя задавать ширину холста, так что большие схемы выглядят так себе
АК
Не уверен про "принято" но plantuml нормально пашет
Спасибо, посмотрю!
Я пока астах использую и на визуал парадигму посматриваю, но если есть варианты близко к пл/скл...
Я пока астах использую и на визуал парадигму посматриваю, но если есть варианты близко к пл/скл...
Н
Близко - это парсеры своего изготовления
Н
Если по схеме данных, то при заданных FK проблема решается кучей тулзов, многие студии умеют это из коробки.
Н
А вот логику и апи, тут голову надо будет поломать. Сильно зависит от архитектуры проекта
NV
Ну и самое время дать ссылку на фундаментальный труд
https://telegra.ph/Uchimsya-risovat-grafiki-v-dokumentacii-bez-dizajnera-i-talanta-07-12
https://telegra.ph/Uchimsya-risovat-grafiki-v-dokumentacii-bez-dizajnera-i-talanta-07-12
НН
: D
АК
Близко - это парсеры своего изготовления
Видел visustin и umlcode, последний вообще сугубо для пл/скл, но первый чисто для схем, без uml, а второй генерит только визуально, не перенесёшь в тот же астах и парадигму...
О... Буду и Ваше творение посмотреть!))
О... Буду и Ваше творение посмотреть!))
НН
Скоро канал оживет, как тока я оживу после праздников
NV
: D
А вот и автор )
ME
: D
ето мой любимый труд)
2019 January 09
SB
Привет! В мире юникс стандартом для написания системной документации является roff (groff, mandoc). Скажите, а за пределами юникса этот формат и тулзы используют для написания документации?
NV
Не встречал ни разу. Это же почти всегда документация для CLI-приложений.
NV
Кстати, Sphinxdoc может выгружать доки в roff, это куда удобнее, чем руками писать разметку.
NV
Наверняка есть и другие генераторы, которые могут
I
Я помню пассаж в pragmatic programmer что они писали книгу в groff, но потом опомнились и перешли на tex
Если вёрстка несложная, то можно писать в md и потом конвертить через pandoc. С техом так точно делают некоторые
Если вёрстка несложная, то можно писать в md и потом конвертить через pandoc. С техом так точно делают некоторые
SB
Ага. Еще есть рассказ Кернигана как они писали "The Go Programming Language" https://rkrishnan.org/posts/2016-03-07-how-is-gopl-typeset.html LATeX у них не пошел и они XML конвертировали в troff и из него уже генерировали PDF.
I
фигасе. Я был уверен, что troff это такая некрофилия
TZ
Ага. Еще есть рассказ Кернигана как они писали "The Go Programming Language" https://rkrishnan.org/posts/2016-03-07-how-is-gopl-typeset.html LATeX у них не пошел и они XML конвертировали в troff и из него уже генерировали PDF.
Восхитительно. "Мы не смогли в ЛаТеХ, поэтому мы решили всё сделать в XML". Это ж надо настолько не справиться с латехом...