Выбор нотации и средства моделирования
💡 Как записать и в каком формате будет лучше передать описание?
Обычно ответ на этот вопрос связан с условиями, в которых ваше описание «пойдет в дело». Его будут читать за обедом? С телефона? При каких обстоятельствах? Сколько времени и внимания будет у адресата описания на то, чтобы его читать?
От этого можно плясать, подбирая формат передачи и нотацию.
Те, кто играют или играли роли, где от успешности составленных ими описаний напрямую зависит доход (например, маркетологи), знают, что неверно выбранный формат и нотация могут убить все содержание, каким бы хорошим оно ни было.
Это верно и для других описаний, хотя и не так заметно.
Есть несколько модальностей представления описаний и разные средства их создания:
- Текстовая: наиболее универсальный формат, со своими издержками, потому что требуется концентрация внимания на чтение слева направо и сверху вниз.
Если текст писать без разметки, то очень быстро становится нечитаемым. Есть форматы текста с разметкой, с ключевыми словами, с выделением цветом (подсветкой синтаксиса), отступами и так далее. Наиболее удобный вариант разметки типов в тексте --- использование двойного двоеточия. Сначала пишется название объекта, затем его тип из мета-модели (или в добавок еще и мета-мета-модели). Например: «самолет::система» или «стол::система::физический объект». Средства, которые могут быть использованы для создания текста --- любые текстовые редакторы по вашему выбору. Существуют текстовые редакторы с подстветкой синтаксиса, и можно использовать подсветку синтаксиса самых простых языков, чтобы видеть только «::».
- Табличная: тоже один из универсальных форматов. Позволяет сконструировать шапку таблички (мета-модель) и заполнить объектами (модель), удобно для онтологического моделирования типовых объектов (особенно если вы умеете настраивать много связанных таблиц в Экселе, Coda.io или подобных моделерах). Каждый объект обладает свойствами (которые пишут в шапке таблицы) а в строках перечисляются сами объекты-экземпляры. Объект любого уровня модели может быть отмоделирован таблично.
- Графовая (имеется в виду не обязательно визуальное представление в виде графа, а подход, в котором объекты связаны произвольным количеством связей). Это поддерживают специализированные онтологические моделеры. В них также можно создавать свои объекты, наследовать свойства и так далее. В этих моделерах также часто реализована проверка типов --- что можно с чем связывать и как, чтобы снять эту необходимость с онтолога. Этим они отличаются от рисовалок диаграмм. Обычно в специализированных моделерах также есть экспорт в текстовый и табличный формат с уплощением объектной структуры.
💡 В итоге: в реальности, когда к вам попадает запрос на описание, где указано, что нужно описать, вам по факту нужно догадаться о том, на каком языке, насколько детально и насколько конкретно вам нужно составить описание, как его записать и как передать.
И это часто нужно сделать быстро, и попыток часто ограниченное количество.
Если вы никогда не обращали внимания на этот процесс, то он происходит автоматически и, скорее всего, не всегда дает нужный результат.
Мы его оттуда вытащим, наладим, отточим и положим обратно --- пусть работает как надо.