Подход к оценке сроков создания технической документации

Cроки и трудоемкость
Нормальным считается коэффициент использования времени 80%
Utilization rate

Сроки и риски
Программист должен был оборудовать стенд, но возникли технические проблемы.
Заказчик должен был прочитать первую версию текста, но у него возникли срочные дела.

Что и как мы будем оценивать?
Трудоемкость
Специалисты
Затраты
Прочие
ресурсы
Сроки
Процедура планирования
Управленческие
соображения

Оценки, основанные на априорных предположениях об объеме документа
Средняя скорость сочинения текста 6 тыс. знаков в день
Распространенное мнение
ГОСТ Р ИСО/МЭК 15910-2002
Почасовой/поминутный метод
Метод нисходящего проектирования:
скандально известные
22 страницы в месяц
Read Me 1st (учебник фирмы SUN)
Почасовой метод

Сравнение оценок ИСО и SUN
Вероятно, авторы по-разному понимают содержание одних и тех же видов работ.

Оценка трудоемкости разработки ПО. Методы, основанные на метриках
I. Начисление баллов по каждой метрике. II. Вычисление обобщенной меры сложности проекта.
III. Пересчет этой меры в строки кода и/или человеко-часы
по нормативам с поправками для конкретной компании.

Проект
«Метрики документирования»
Идея:
«скрестить» нормативы по видам работ
с метриками задачи
Единичный предмет оценки — т. н. связный текст.
Оцениваются трудозатраты основного автора текста.
В таблице нормативов учитывается вклад каждой
метрики в трудоемкость по каждому виду работ
Строятся отдельные таблицы нормативов для разных видов
документации и типов предметов документирования.
Лучшая таблица нормативов в своем классе
выявляется входе конкуренции.
Отправные точки:

Время интервью
Время работы на стенде
…
Сумма (взвешенная) трудозатрат по видам работ
Устройство таблицы нормативов
Метрики задачи
Нормативы трудоемкости по видам работ
ИТОГО:
= nTni + tTti+ fTfi+…
= nTns + tTts+ fTfs+…

Гибкость методики расчета
Коэффициенты в таблице могут быть отрицательными. Например, большой объем проектной документации время на чтение последней увеличивает, а время на интервью
и стенды снижает.
Трудозатраты по видам работ можно суммировать
с весами, зависящими от организации работы
в конкретной компании. Например, если участники документирования размещены в разных офисах,
то при всех работах, требующих личного контакта, надо ставить повышающие веса.

Предлагаю всем желающим принять участие в проекте
Загрузите черновик оценочной таблицы
со страницы http://www.philosoft.ru/metrics.
Из ваших ближайших задач выберите более-менее полную по составу работ.
Постарайтесь посчитать значения предлагаемых в таблице метрик задачи.
Постарайтесь засечь время, потраченное вами
на выполнение работ каждого вида.
Пришлите вашу таблицу нам для анализа (детали изложены на странице проекта).