Если вы напишете хорошую техническую спецификацию до начала этапа разработки, у вашей команды будет четкий план работы, а заинтересованные стороны смогут сформировать реалистичные ожидания — это беспроигрышная ситуация.
Разработка программного обеспечения — изначально рискованный бизнес. И, по словам Джоэла Спольски, основателя Trello, работа без технической спецификации делает ее еще более рискованной.
“Неспособность написать спецификацию — это самый большой ненужный риск, на который вы идете в проекте программного обеспечения. Это так же глупо, как отправиться пересекать пустыню Мохаве в одной одежде за спиной, надеясь ‘окрылить его”.
Итак, если вы не хотите, чтобы неожиданные неудачи помешали прогрессу ваших разработчиков, лучше всего заранее изложить элементы проекта.
Допустим, вы создавали веб-сайт, на котором пользователи должны регистрироваться.
В этом случае вы не смогли бы начать писать код для регистрации, забытых паролей или чего-либо еще без реальных слов, которые появились бы на экране.
Именно поэтому Спольский рекомендует писать технические https://vista-vklad.ru/svidetelstvo-o-gosudarstvennoj-registratsii-produktsii/ спецификации. Вот его пример экрана входа в систему, заполненного реальным контентом.
Если в вашей технической спецификации указаны точные компоненты вашего решения, вашей команде не придется принимать решения на месте, что сведет к минимуму риски, связанные с неправильными или поспешными решениями.
Аналогичным образом, наличие определенного видения продукта позволяет всем заинтересованным сторонам, включая клиентов, быть хорошо информированными.
Когда в вашей технической спецификации указано, для чего продукт не предназначен, никто не сможет пожаловаться на отсутствие функции, которой там никогда не должно было быть.
Наконец, технические спецификации также полезны для управления проектом.
Отслеживание прогресса проекта и сравнение его с графиком, предложенным в спецификации, поможет вам более эффективно распределять ресурсы и при необходимости корректировать темп работы.
По сути, техническая спецификация может быть одним документом, но это мощный документ, потому что он приносит преимущества нескольким сторонам, вовлеченным в продукт.
Что нужно сделать перед написанием технических спецификаций
Вдохновило ли вас чтение о преимуществах начать работу над технической спецификацией для вашего следующего продукта? Если это так, отлично!
Есть еще несколько вещей, которые вам нужно определить, прежде чем вы погрузитесь в перечисление функций и присвоение имен конечным точкам.
Чтобы создать эффективную техническую спецификацию, вы сначала должны определить ее назначение.
Когда серверный разработчик Делла Анже работала с техническими спецификациями в Lyft, она узнала, что только хорошо продуманные спецификации приносят пользу процессу разработки.
Анджех даже называет технические спецификации без цели “пустой тратой времени” и советует задавать следующие вопросы перед написанием документа:
“Чего я надеюсь достичь с помощью этой технической спецификации?”
Ответ на этот вопрос даст вам направление для создания документа.
Например, если вы хотите, чтобы ваша техническая спецификация внесла единообразие в процесс разработки, вы знаете, что вам придется посвятить значительную часть документа перечислению точных названий полей или конечных точек.
Приведенная ниже таблица Anjeh показывает еще несколько примеров того, какой может быть цель технической спецификации и как она управляет направлением документа.