Z
чтоб синхронно вносить изменение и в конфигурацию и в обработки/расширения и в документацию.
Size: a a a
2021 March 31
Z
и документацию так можно быстро собирать в статический сайт.
Z
посмотри как сайты bsl ls или ванессы автомжйшн сделаны
АМ
посмотри как сайты bsl ls или ванессы автомжйшн сделаны
Нет, ну по мелочам я MD пользуюсь. И исходники внешних обработок в репе храню. Т.е. предполагается что программист после разработки очередного отчета помимо выгрузки в исходники еще напишет краткое описание (или доработает уже существующее) в формате MD?
АМ
и эти файлы кладутся именно в каталог исходников соответствующей внешней обработки?
Z
Александр Медведько
и эти файлы кладутся именно в каталог исходников соответствующей внешней обработки?
это как договоритесь, чаще всего рядом
Z
ну есть готовые всякие бойлерплэйты проектов кто как ведет
АМ
это как договоритесь, чаще всего рядом
Рядом? Т.е. это отдельный большой MD на все обработки? :)
Z
но лучшим будет тот который вы внутри командысамм составите
Z
можно отдельный
АМ
Я пытаюсь узнать практику существующую чтобы привнести ее ... дух :)
Z
можно так чтоб имя обработки повторял
Z
можно в соседнюю папку класть, например docs/name.md
Z
лучше документы в docs папку кидать тогда в будущем проще прикрутить статик генератор сайта будет
АМ
Z
мне больше всего mkdocs нравится
Z
смотри ну классно же он смотрится
Z
многие еще hugo юзают
Z
а можно еще больше и лучше