Часто бывает, что невозможно изложить что-то, не опираясь на какие-то базовые и однозначно понимаемые всеми термины (понятия). В таких случаях сначала нужно определить всю необходимую терминологию (предоставить описание предметной области), а только затем приступать к изложению.

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

Если вы пишете документ, в котором однозначное понимание слов крайне важно, то, без сомнения, создавайте раздел с определениями слов. Я предпочитаю полную ясность и поэтому определяю терминологию всегда, когда это уместно.

Описание предметной области - Примеры

Примеры неудачных определений

Итератор - это чистая абстракция, то есть все, что ведет себя как итератор и есть итератор.

Существование - деятельность организма для удовлетворения витальных потребностей.

Примеры правильных определений

Технико-экономическое обоснование (ТЭО) - документ, который доказывает, что проект технически возможен и экономически выгоден. ТЭО - это документ-идея.

Бизнес-план - документ, который дает подробную информацию о том, кто собирается реализовать бизнес-проект, каким образом, в какие сроки и на каком рынке. Бизнес-план - это документ-реализация.

Пример правильных определений без создания специального раздела

Прежде чем начать предлагаю разобраться в понятиях "жизнь" и "существование".

Существование - деятельность человека как организма. Деятельность, направленная на удовлетворение потребностей необходимых для биологического функционирования.

Жизнь - деятельность человека как личности. Не учитывая сложностей социальной философии, предположу что, жизнь - это развитие, созидание, свобода действий...

Описание предметной области - Пример с диаграммой

Представленное ниже описание предметной области используется при моделировании бизнес-процессов, а также при разработке программного обеспеченья. К сожалению, здесь я не буду объяснять правила построения таких диаграмм (подробнее об этой графической нотации см. UML).

Для лучшего понимания предметной области диаграмма дополняется описанием.

Заказчик

Продукт

…

Экземпляр

Один и тот же продукт может иметь несколько копий и размещаться на разных площадках (на площадке разработчика, на площадке тестировщика, на демонстрационной площадке и т.д.). Каждая такая копия продукта называется Экземпляром.

…