d9e5a92d

Заранее проведенное документирование


Иногда вы можете заметить, что не используется оптимальная ком­бинация методик документирования. Для упрощения коммуникации между различными направлениями во многих организациях одна или несколько методик разрабатываются как стандартные методики. Когда стандартные методики отвечают желаемым целям, то проблем с ними относительно немного. Настоящие проблемы возникают, когда доступ­ные стандартные методики оказываются неприменимы. Потребность во введении новой, более подходящей методики документирования гово­рит сама за себя, однако часто приходится сталкиваться с противодей­ствием, поскольку внедрение другой методики слегка усложняет про­цесс внутренних коммуникаций.

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

 





Содержание раздела