AK
Как по мне это прикольно, но не более того. Ценность в том, чтобы проверить, что метод возвращает то, что описано : )
Size: a a a
2017 March 31
L
в основном ценно конечному пользователю, а для нас скорее фан, да)
L
клиент хочет например попробовтаь передать живые параметры, чтобы создалась какая-то сущность
L
просто более дружелюбная замена curl
AK
Мы упустили из виду важный вопрос — для кого документация, внутри команды разработчиков или же для внешних пользователей, скажем для команд, которые пользуются разрабатывааемым сервисам и тд.
AK
Я рассматриваю пока только в плане внутреннего использования, для внешнего пока делали только markdown и на гитхабе, что вполне работает.
ЕД
Коллеги, а DITA кто-нибудь пользуется?
SS
в Питере многие: Digital Design, Беркут, МТС например
SS
Елена Толмачева - эксперт по дите
ЕД
Я хочу у себя внедрить как technology owner, но боюсь, что стоимость внедрения в плане усилий будет больше, чем экономия времени, которую она даст
ЕД
Учитывая, что у нас для всего используется Zendesk
ЕД
Т.е. не версионирования, ни процесса внесения изменений пока нет
ЕТ
Если с умом внедрять, то быстро.
ЕТ
Егор, а с какой целью вы DITA хотите внедрять? Я могу подсказать - стоит или нет.
ЕД
Лично у меня, как лида писателей, несколько целей: 1. Сделать единый источник для документации 2. Повторное использование тасков 3. Сделать консистентной всю документацию, с центральным внесением изменений, которые потом будут деплоиться везде 4. Отделить содержимое от представления
ЕД
В общем, порядок навести в своем доме
ЕТ
у вас ГОСТ? схем много?
ЕТ
таблиц?
ЕД
Ну и процесс написания сделать гуманным, чтобы ни на одном этапе вордовских документов не было. Нет, мы иностранная компания. Даже ISO не обязательно.
ЕД
Таблиц почти нет, все диаграммы - картинками из экспорта визио