Термины, которых следует избегать в спецификации требований

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

Таблица 6‑1. Устранение неоднозначностей в формулировках требований

Контроль версий

Контроль версий – это важный аспект управления спецификациями требований и другими проектными документами. Каждой версии следует присвоить уникальный идентификатор. У каждого члена команды должен быть доступ к текущей версии требований, а изменения необходимо ясно документировать и передавать всем заинтересованным сторонам. Чтобы минимизировать путаницу, конфликты и непонимание, назначьте право обновления требований строго определенным лицам и убедитесь, что идентификатор версии изменяется при каждом изменении требования.

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

Простейший механизм управления версиями – именовать вручную каждую версию спецификации требований к программному обеспечению согласно соглашению. Попытка различать версии документов по дате изменения или дате печати часто приводит к ошибкам и неразберихе.