Описание обязательно создается для совершения дейстия в реальном мире. У описания обязательно есть цель — чтобы целевое действие совершилось. Описать объекты N, чтобы агент A выполнил действие X. Хорошее, работающее описание можно создать по простым шагам:

  1. Выявить, узнать целевое действие для описания. Без этого описание обречено на провал. Целевое действие запрашивается у заказчика описания, если в самом запросе описания цель не ясна. О цели лучше всего спросить прямо — “в результате потребления описания что должно произойти, с кем и как”; с кем и как важны, чтобы не скатываться в размытые и общие запросы вроде “чтобы стало лучше, чтобы доход рос, чтобы сотрудники не ругались”. Если нет возможности спросить прямо, то узнать косвенно: собираемвыявляем максимум контекстной информации о заказчике, прямо спрашиваем про его роль/роли (“вы как кто это запрашиваете?”) или понимаем их из контекста. На основе этой информации строит гипотезы о целях описания и проверяем эти гипотезы, лучше всего явно — “я верно понимаю, что вы хотите … ?”.

  2. Провести исследование — чего не хватает, чтобы подобрать язык для описания. На выходе — список недостающей информации. Кроме языка здесь важны эпистемический статус агента (адресата описания), понятийное расстояние. По шагам: - Кто адресат описания — это максимально важно, так как не зная адресата мы составим описание для никого, потратим время впустую, шанс, что описание сработает, минимальный. - Какие объекты надо описать? в какой части реального мира эти объекты находятся? в разрезе каких понятий / в какой нарезке* их надо описать? насколько детально и насколько конкретно? * пример про нарезку: описать панамку в разрезе материалов и техники сшивания или в разрезе фасона, цвета или в разрезе себестоимости и торговой цены? - На каком языке описывать? какие термины будут понятны адресату? надо ли приложить интерпретатор? - В каком формате описываем (картинка, схема, текст, видео-инструкция, канбан-карточка, устное объяснение) и в какой нотации? - Какая цель агента-потребителя описания? Он будет использовать описание для работы, для каких-то других дел / целей? - Каков эпистемический статус агента? Что он уже знает о той предметной области, про которую мы собираемся ему сообщать? Выполнял ли он подобные действия раньше? - Какое должно быть содержание описания, чтобы привести агента-потребителя в необходимый нам статус?

  3. Собрать недостающую информацию — в идеале собирать информацию у прямых адресатов, у тех, кто будет читать описание и что-то делать по нему. По шагам: - Прямо спросить у адресатов всё, что нам непонятно. - В случае если спросить нельзя, то построить гипотезы и проверить их: - предположили нарезку и язык — пообщались этим языком по этой нарезке — при необходимости скорректировали язык и нарезку - предположили уровень подробности и уровень абстракции — проговорили самые мелкие и самые крупные объекты интереса, проговорили максимально конкертные и наиболее абстрактные объекты / понятия — скорректировали при необходимости.

  4. Спроектировать описание — подобрать язык, настроить максимы кооперации. По шагам: - Чтобы подобрать язык стоит также понять на каком участке спектра точности удобно / привычно / комфортно общаться потребителю описания. - Также важно предположить понятийное расстояние, чтобы понимать шаг, который может делать агент, то есть как быстро он будет усваивать новые для него картины мира из нашего описания. 8) Создать описание — по шагам: - Явно (текстом/таблицей) изложить (для себя!) все мета-данные для описания: целевое действие, роль заказчика, кто адресат, его статусы, язык и нарезка, понятийное расстояние и удобный уасток спектра, etc. - Создать полный текст, соблюдая следующие правила: - Один абзац — одна мысль в формате тезис—аргумент/доказательство—вывод/итог. - В начале обозначить, о чем будет описание и зачем оно нужно агенту-потребителю


#описание #коммуникация #цель #надсистема

Принцип кооперации в коммуникации — все максимы важно соблюдать каждом виде коммуникации, в том числе и в описании.

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

Провалы в целеориентированном описании — не всегда удается достичь цели сразу, за один поход к описанию, это итеративный процесс; но есть частые причины провала, про которые стоит знать заранее

Описание и требования к нему — все описания делаются для выполнения каких-то действий, поэтому почти каждое описание стоит рассматривать целеориентированное описание.