dastapov | Хороший глоссарий

Всем известно, что хороший глоссарий терминов, которым владеют все члены проектной команды, здорово помогает вести дискусии, писать внятные документы и т.п.

Чем более простыми, понятными, близкими к жизни и не перегруженными дополнительными смыслами будут наши термины - тем проще нам будет общаться.

Возьмем для примера простой веб-интерфейс, позволяющий пользователю задать (и сохранить) SQL-запрос, результаты выполнения которого будут либо красиво показаны пользователю в виде HTML-таблицы. либо будут отсылаться ему на e-mail, и на этом простом примере покажем, как должен выглядеть Образцовый Глоссарий.

Процедура управления шаблонами отчетов системы XYZ

Представление отчета (Отчет) - документ, содержащий данные в Форме отчета, полученный в результате выполнения Шаблона

Шаблон отчета - хранимая програмная логика, предназначенная для многоразового получения Отчетов на основе применения данного Шаблона

Форма отчета - форма и формат представления экземпляра отчета и его данных, используемые Шаблоном для получения Представления Отчета.

Вот так-то. Как видите, непростое это дело - писать глоссарии :)

PS
К счастью, аффтар уже убил себя ап стену и больше не пишет.