VP
СКД - там одним редактированием текста запроса не ограничишься. Все поломается же.
Size: a a a
2019 December 12
VP
А если все делать программно, то изобретешь тот же самый конструктор СКД
VP
Если не предвидится переезд конфы в какое-нибудь облако, где конфигуратора нет, то продолжай пользоваться толстым клиентом для редактирования СКД. Тем более в типовых такой же сценарий.
ВМ
Ок спасибо.
С
Коллеги , а есть у кого-то наработки по хранению и редактированию документации по конфе прямо в составе конфы ? Сейчас есть дока в своей докувики, но это без привязки к конфе и докувики на локальном портале, наружу не отдашь. Как вижу - маркдаун с возможностью вставок картинок, для редактирования и настроек, с возможностью вставки ссылок на объекты метаданных и формы. Все это рендерится в HTML и отображается пользователю
С
Все это, конечно в тонком клиенте )
DO
Смирнов
Коллеги , а есть у кого-то наработки по хранению и редактированию документации по конфе прямо в составе конфы ? Сейчас есть дока в своей докувики, но это без привязки к конфе и докувики на локальном портале, наружу не отдашь. Как вижу - маркдаун с возможностью вставок картинок, для редактирования и настроек, с возможностью вставки ссылок на объекты метаданных и формы. Все это рендерится в HTML и отображается пользователю
СППР умеет генерировать встроенную справку для объектов конфигурации, сам не пробовал
ВБ
где-то на ифостате валялось преобразование кода в докумментацию доксигеном. доксиген умеет выводить в хмл, хмл может грузиться 1с.
DO
Валентин Бомбин
где-то на ифостате валялось преобразование кода в докумментацию доксигеном. доксиген умеет выводить в хмл, хмл может грузиться 1с.
есть еще вот этот проект, но это про техническую документацию, а не пользовательскую
https://github.com/bia-technologies/autodocgen
https://github.com/bia-technologies/autodocgen
С
СППР умеет генерировать встроенную справку для объектов конфигурации, сам не пробовал
На инфостарте человек конкретно юзаюший СППР не рекомендовал использовать ее при разработке в командах менее 30 чел. Я до этого сомневался, теперь не сомневаюсь , что она для нас тяжеловата
DO
лично я пробовал использовать asciidoc и хранить документацию в одном репозитории с конфигурацией.
из плюсов asciidoc - возможность ссылаться на произвольный участок произвольного файла и подставлять этот участок в документацию при сборке проекта
pdf генерится одной командой:
из плюсов asciidoc - возможность ссылаться на произвольный участок произвольного файла и подставлять этот участок в документацию при сборке проекта
pdf генерится одной командой:
asciidoctor-pdf -o build\\docs\\ТехническаяДокументация.pdf docs\\ТехническаяДокументация.adoc
С
Валентин Бомбин
где-то на ифостате валялось преобразование кода в докумментацию доксигеном. доксиген умеет выводить в хмл, хмл может грузиться 1с.
Больше интересует пользовательская , чтоб с картинками
ВБ
для пользовательской даже не знаю что подойдет - там слишком много требовний взаимоисключающих - и что бы легко, и что бы полно и проверки языка и в тоже время - понимание сленга.. Я бы в сторону scribble/pollen глянул - может там какие идеи почерпнутся
DO
еще плюсы asciidoc - автоматическая генерация содержания, указателей, подстановка колонтитулов, стили
ВБ
по крайней мере scribble - это удобно (а также стильно, модно и молодежно)
С
лично я пробовал использовать asciidoc и хранить документацию в одном репозитории с конфигурацией.
из плюсов asciidoc - возможность ссылаться на произвольный участок произвольного файла и подставлять этот участок в документацию при сборке проекта
pdf генерится одной командой:
из плюсов asciidoc - возможность ссылаться на произвольный участок произвольного файла и подставлять этот участок в документацию при сборке проекта
pdf генерится одной командой:
asciidoctor-pdf -o build\\docs\\ТехническаяДокументация.pdf docs\\ТехническаяДокументация.adoc
Pdf я могу нагенерть из своей докувики. Но мне не чтобы было, а чтобы пользоваться ) pdf пользоваться не понятно как.
ВБ
Смирнов
Pdf я могу нагенерть из своей докувики. Но мне не чтобы было, а чтобы пользоваться ) pdf пользоваться не понятно как.
что бы пользоватья - документаия должна обновлятся. что бы обновлятся - ее нужно обновлять. Так что все упирается в это, а не в формат
T
если не лень писать фича-файлы, то можно ванессу припахать - https://infostart.ru/public/1133932/ Можно делать пошаговые инструкции в HTML или маркдаун.
С
Валентин Бомбин
что бы пользоватья - документаия должна обновлятся. что бы обновлятся - ее нужно обновлять. Так что все упирается в это, а не в формат
Готовы обновлять, но это должно быть удобно )
DO
Смирнов
Готовы обновлять, но это должно быть удобно )
удобно пользоваться или удобно редактировать?
по поводу удобно пользоваться - что может быть удобнее pdf? статичный сайт?
по поводу удобно пользоваться - что может быть удобнее pdf? статичный сайт?