Семён Факторович — Пять значений фразы «Нам нужно всё задокументировать»
Автор: Flow — конференция про системный и бизнес-анализ
Загружено: 2024-03-06
Просмотров: 107
Описание:
Подробнее о конференции Flow: https://jrg.su/CAm5kF
— —
Последние пять лет спикер занимается заказной разработкой документации для российских IT-компаний. Разговор почти с каждым клиентом начинается с фразы: «Нам нужно всё задокументировать, помогите нам в этом».
Опыт показывает, что разные компании понимают под этой формулировкой довольно разные вещи, и «всё» в разных компаниях тоже отличается. В практике команды спикера эти просьбы сводятся к пяти направлениям работы:
— Описание требований к уже существующей системе — реверс-инжиниринг требований.
— Создание пользовательской документации.
— Создание архитектурной документации, адресованной исключительно разработчикам.
— Создание API-документации — причем обычно речь идет о вводных и обучающих статьях (howtos/tutorials), а не к непосредственному написанию аннотаций к методам.
— Комментарии в коде — в стиле Javadoc или в свободном формате.
В докладе обсуждаем, что общего у этих направлений, чем они отличаются и что делать, если вам нужно решить одну из подобных задач. Доклад будет интересен всем, кто занимается разработкой документации, и всем, кто руководит или участвует в таких активностях.
Скачать презентацию с сайта Flow — https://cutt.ly/pwDskHD4
#documentation
Повторяем попытку...
Доступные форматы для скачивания:
Скачать видео
-
Информация по загрузке: