AR
вполне, иначе для чего придумали опрос "Понравилась ли вам статья" во многих открытых документациях
Size: a a a
2021 July 09
AE
не понял вас
ML
требовать — правильно. Можете ли вы через суд заставить его это сделать — нет, конечно.
Невозможно выписать критерии актуальности или хорошести документации
Невозможно выписать критерии актуальности или хорошести документации
AR
я к тому, что собирать отзывы по документации у заказчиков это нормальная практика
AE
вы наверное не поняли меня правильно.
подрядчик пару лет назад сделал документацию в проекте и доки ушли на этап эксплуатации.
местные ит-спецы ведут свои доки по мере надобности, а доков от представителя разраба не приходит от релиза к релизу.
подрядчик пару лет назад сделал документацию в проекте и доки ушли на этап эксплуатации.
местные ит-спецы ведут свои доки по мере надобности, а доков от представителя разраба не приходит от релиза к релизу.
AR
ну вы смело можете им писать и спрашивать обновленную документацию
AR
и я вас прекрасно поняла) если у вас есть проблемы с разработчиками софта, их всегда можно решить, обратившись в саппорт или напрямую к разработчикам
А
зависит от типа и условий договора. по изменениям и доработкам следует заключать допники с обязательным условием актуализации доков. иначе за что вы платите деньги? код без доков, как дом с коммуникациями без чертежей)
J
Коллеги, никто не подскажет вот по этому вопросу? Критично
AE
на данный момент нет договора на тех. поддержку. надо его заключить и указать об актуальности доков по последним версиям?
А
а вот это вообще критично. доки должен поставлять разраб к релизу. а какие ведут доки местные? по своим доработкам внутри купленной системы? тут нужно сначала регламент разрулить.
А
это не договор тех.поддержки. он по большому счету регламентирует устранение багов. должно быть дополнительное соглашение к основному договору на доработку системы с отгрузкой актуальных доков.
AE
спасибо всем. я получил здесь больше полезных ответов, чем в других чатах.
D
Коллеги, подскажите, можно ли по-человечески пользоваться AsciiDoc на Windows? Имеется в виду создание доки и ее публикация.
NV
WSL2 можете использовать? Если да, то вообще никаких ограничений не должно быть.
D
Ясно, спасибо!
NP
Asciidoctor можно и без wsl2, проблема в подключаемых модулях. Под Linux в целом всё запустить гораздо проще. Для документации (не только Asciidoctor) это важно, так как часто необходимо комбинировать технологии из разных эко-систем. Wsl2 достаточно медленно работает. Virtual Box быстрее и VMWare еще быстрее (практически как будто бы linux была основной системой). Правда, VMWare платен.
FM
Да, можно. Я сижу на винде и разрабатываю доки на аски.