Видеодоклад по презентации https://www.youtube.com/watch?v=10mk8niMWl0&t=742s
История о том, как наша команда попыталась организовать процесс подготовки и учета документации, увеличить «полезную нагрузку» создаваемых документов и сократить количество дублирования информации. Будут приведены примеры практик, широко практикующихся разработчиками, которые были адаптированы для подготовки документации и как сам процесс подготовки документации был встроен в процесс разработки.
5. AGILE МАНИФЕСТ
Люди и взаимодействие важнее процессов и
инструментов
Работающий продукт важнее исчерпывающей
документации
Сотрудничество с заказчиком важнее согласования условий
контракта
Готовность к изменениям важнее следования
первоначальному плану
6. ОСНОВНЫЕ СЛОЖНОСТИ
Большое количество отчетной
документации
Низкая (практическая) польза
(для команды)
(bonus) подготовка возложена
на команду разработчиков исчерпывающая
документация
работающий
продукт
8. ДОКУМЕНТАЦИЯ
Цели
Минимизировать объем
создаваемых документов
Максимизировать пользу
создаваемых документов
Обеспечить актуальность
документации
Для чего создается*
Для разработки ПО
Для использования ПО
Для заказчика
9. DRY (DON’T REPEATYOURSELF)
Каждая часть знания должна иметь
единственное, непротиворечивое и
авторитетное представление в
рамках системы
19. 3 AMIGO MEETINGS*
Участники команды проводят ревью одной документации
Все полученные замечания классифицируются
По всем замечаниям прорабатываются решения
Решения согласуются командой
Полученные результаты фиксируются
23. РЕВЬЮ
Кто проводит
Аналитик
Тестировщик
Технический писатель
Разработчик
Структуру
Оформление
Стиль
Полноту
Содержание
Что проверяют
25. РЕТРОСПЕКТИВА*
Участники команды проводят ревью одной документации
Все полученные замечания классифицируются
По всем замечаниям прорабатываются решения
Решения согласуются командой
Полученные результаты фиксируются
27. ЖЦ ЗАДАЧИ НА РАЗРАБОТКУ
Разработка Контроль
Тестирование,
исправление
ошибок
Актуализация
рабочей
документации
Требуется доработка
Начало Конец
Не требуется актуализация документации
33. РУКОВОДСТВО АДМИНИСТРАТОРА
Передача заказчику
исходных кодов ПО,
конфигурационных файлов,
скриптов запуска.
Описание в документации
запуска скриптов,
конфигурирующих среду.
система управления
конфигурациями
34. ВЗГЛЯД В БУДУЩЕЕ
Сокращение количества избыточности
отчетных документов
Исключение «устаревших» документов
Переход к электронным версиям
документов
Внедрение ЭЦП в документооборот
35. БУДУЩЕЕ УЖЕ РЯДОМ ;-)
http://zakupki.gov.ru/epz/contract/contractCard/document-info.html?reestrNumber=1771047437516000071