Документирование в ИТ-проектах: своими силами или нанять стороннего исполнителя?
На разных стадиях жизненного цикла проекта возникают различные потребности и сложности.
Если вы хотите использовать эти знания в текущем периоде и в последующей работе, необходимо все документировать. Своими силами или отдать документацию на аутсорсинг? Рассмотрим подробнее.
Проблематика документирования — в недостатке информации
Если изначально в проекте документирование велось недостаточно хорошо, с расширением штата ситуация только усугубляется. И приходит время, когда новые участники команды не могут полностью погрузиться в проект, поскольку им не хватает информации. Как результат, только отдельные сотрудники понимают каждый этап проекта (зачастую те, кто стоял у его основ).
Чтобы это исправить, нужно частями у сотрудников собрать информацию, понять историю всех этапов и начинать описывать работу проекта.
Однако на практике это происходит довольно непросто. И поскольку документирование в проекте с самого начала в надлежащем виде не велось, нередко бывает, что собрать всю информацию в полном виде уже невозможно.
Понимая проблематику, руководитель IT-проекта задумывается о том, чтобы не тратить внутренние ресурсы, а передать этот участок работы стороннему исполнителю. Прежде чем говорить, о том, насколько такой вариант хорошо, давайте разберемся, какая бывает документация в проекте.
Виды документации
При разработке ПЗ документация объясняет функциональность продукта, унифицирует информацию и становится основой для обсуждения важных моментов с заказчиком.
Поход к разработке ПЗ напрямую влияет на тип документации и ее объем. Например, Agile основан на коллективной работе, тесном сотрудничестве с клиентами и заинтересованными сторонами, гибкости и способности быстро реагировать на изменения. И на начальном этапе данный метод не требует всесторонней документации.
В данном случае ее можно разделить на две основные категории. Первая — Product documentation (документация по продукту) — описывает продукт и содержит инструкции по выполнению различных задач с ним. Другими словами, речь идет о требованиях, технических характеристиках, логике и мануалах. Основные типы Product documentation:
• System documentation — описывают саму систему и ее части (Requirement documents, Design decisions, Architecture descriptions, Program Source code, Testing documents).
• User documentation — инструкции, зачастую предназначенная для конечных пользователей продукта и команды поддержки (Tutorials, User guides, Troubleshooting manuals, Installation, Reference manuals).
Вторая категория документов — Process documentation (документация процесса) — описывает процесс. Сюда могут входить Standards, Project plans, Test schedules, Reports, Meeting notes и т. д.
Чтобы сформировать документацию, которая будет помогать вашей команде во всех проектах, стоит описывать следующие разделы:
• roles and responsibilities (роли и обязанности);
• team goals and business objective (цели команды и бизнес-цели);
• background and strategic fit (предыстория и стратегия);
• assumptions (предложения);
• user stories (пользовательские истории);
• acceptance criteria (критерии принятия);
• user interaction and design (взаимодействие пользователей и дизайн);
• questions (вопросы);
• not doing (не делать).
Аутсорсинг в документировании
Получение качественной услуги от сторонней компании не определяется только подписанием соответствующего договора. В IT-проекте важны все детали и, если пропустить хотя бы одну, это может привести к существенным проблемам. Следовательно, сторонняя компания, выполняющая документирование, должна глубоко вникнуть в особенности проекта, а так происходит далеко не всегда. Здесь и кроется главный недостаток аутсорсинга.
IT-проекты, которые приглашают сторонние ресурсы для тестирования, разработки или документирования, нередко сосредоточены на удешевлении таких услуг. Однако опыт показывает, что на подобных этапах экономить точно не стоит.
Качество выполнения документирования подрядчиком определяет не количество задействованных людей, а наличие опыта работы в подобных проектах, подход к организации процесса, взаимозаменяемость сотрудников и отлаженная система менеджмента.
Выбирая стороннюю организацию, в данном случае важно понимать, что создание документации столь же ресурсно-затратный процесс, как разработка или тестирование.
В то же время, назначить в IT-проекте одного человека, который самостоятельно полностью его опишет, не получится. Этим должна заниматься вся команда под тщательным контролем.
Итак, мы убедились в необходимости документировать работу IT-команды и рассмотрели возможность привлечь для этого подрядчика. Недостаток такого варианта заключается в риске не получить желаемый результат. А своими силами документировать не всегда выходит по организационным причинам. Что же делать? Вариантов несколько. Первый — выделить своего сотрудника, который хорошо знает все процессы, и обязать его контролировать документирование на всех этапах и всеми участниками команды.
Второй вариант — не думать об экономии, а все же отдать документирование на аутсорсинг, выбрав исполнителя, чей опыт и практика являются гарантией качественного предоставления услуги.
- Лідерство розгортання: коли стратегія виходить за межі кабінету Жанна Кудрицька вчора о 19:06
- Як навчитися ухвалювати рішення на перемовинах? Розглядаємо на прикладі покеру Владислав Пʼявка вчора о 14:57
- Встигнути до штормів: чи готові інвестори до українських податкових гірок? Сергій Дзіс вчора о 10:40
- Від парової тяги до цифрової етики: як змінювалось людство й корпоративна безпека Ігор Шевцов вчора о 08:54
- "Справедливість" судді Канигіної Лариса Гольник 12.05.2025 18:43
- Нові правила для енергонакопичувачів: як зміняться контракти через кіберризики з 2025 Ростислав Никітенко 12.05.2025 15:01
- Як довести вину стоматолога у суді: практика відшкодування шкоди за неякісне лікування Артур Кір’яков 12.05.2025 13:59
- Форензик як інструмент захисту, діагностики та зростання бізнесу в умовах ризиків Артем Ковбель 12.05.2025 03:29
- Вбивчі цифри: як звички й випадки скорочують життя Христина Кухарук 11.05.2025 13:54
- Відповідальна особа з питань захисту персональних даних: новий гравець у структурі бізнесу Анастасія Полтавцева 10.05.2025 14:43
- Як зруйнувати країну Андрій Павловський 10.05.2025 14:34
- Інтелектуальна власність як актив бізнесу Сергій Пагер 10.05.2025 14:21
- Стейкхолдери – основний локомотив сучасної якісної освіти Сергій Пєтков 09.05.2025 10:49
- "Спорт внє палітікі?". Як би ж то! Країна-агресор хоче повернутися у міжнародний спорт Володимир Горковенко 09.05.2025 10:10
- Землі заказника "Лівобережний" у Дніпрі: історія зміни статусу та забудови Павло Васильєв 08.05.2025 22:23
- Як зруйнувати країну 368
- Вбивчі цифри: як звички й випадки скорочують життя 213
- Безбар’єрність у лікарнях: чому доступ до медичних послуг виходить за межі пандусів 155
- Від парової тяги до цифрової етики: як змінювалось людство й корпоративна безпека 130
- Кабальні "угоди Яресько" блокують економічне відновлення України 118
-
Угорщина готується до війни? Що стоїть за "шпигунами Орбана" на Закарпатті
38475
-
Експерти з психіатрії назвали п’ять речей, які ніколи не роблять щасливі пари в стосунках
Життя 12795
-
"ЗСУ знищили російську армію. Путін будував її 10 років", – генерал армії США Дуґлас Лют
12047
-
Підготовка піхотинців: державна некомпетентність і приватна ініціатива
Думка 11994
-
На стамбульській розтяжці – як Путін нарешті змушений зіткнутися з реальністю
Думка 11599