Привет! Меня зовут Данила, и я занимаюсь менеджментом, рисками и всем тем, что называют бумажной безопасностью. В этой статье под документом я буду понимать любой разрабатываемый материал, имеющий текст (протоколы, нормативные документы, презентации, white paper’ы и т.д.)
Поговорим о проблеме
На днях я читал положение, которое нам прислали консультанты. Документ оказался откровенно плохим; у меня набралось порядка 70 комментариев на 5 страниц сухого текста. Все плохо, задумался я; а еще задался вопросом: а что отличает хорошее управление документом от плохого вне зависимости от того, кто этот документ пишет?
Я попытался поискать в Интернете ответы, но особо ничего не нашел. Разрозненные статьи с разрозненными правилами; единого стандарта нет.
Значит попробую сформулировать критерии сам. Что выделяет хороший документ
-
с ним ознакомлены все заинтересованные стороны;
-
все знают где он лежит;
-
все знают у кого можно получить комментарии по поводу его положений;
-
легко читается;
-
легко воспринимается;
-
имеет четкую структуру;
-
его можно выполнить;
-
он отражает реальность;
-
на него можно повлиять.
Все эти критерии можно сложить в 4 принципа:
-
Прозрачность и доверие;
-
Адаптация под читателя;
-
Реалистичность и достижимость;
-
Обратная связь.
4 принципа формируют концепцию ПАРО (по первым буквам).
Поговорим о концепции ПАРО подробнее
Я постараюсь описать каждый принцип и практики, которые можно применять для его выполнения.
Прозрачность и доверие
Отсутствие прозрачности документа может вызвать проблемы с информированием лиц, на которых он распространяется. Это, в свою очередь, повлечет несоблюдение требований, ошибочные управленческие решения и рост рисков.
Кроме того, недостаточная ясность снизит доверие к документу и ухудшит коммуникацию между заинтересованными сторонами, уменьшив ее эффективность.
Практики:
-
Указывайте авторов. Важно чтобы заинтересованные лица могли обратиться к автору за разъяснениями.
-
Указывайте версионность документа. Важно чтобы все заинтересованные лица использовали одинаковый документ.
-
Фиксируйте изменения в новых версиях. Кратко укажите какие изменения произошли, это ускорит ознакомление с новой версией документа.
-
Используйте современные форматы документов. Используйте такие форматы как .docx или .pdf. Старые форматы могут открываться некорректно.
-
Обеспечьте доступность документа. Все заинтересованные стороны должны иметь доступ к документу.
-
Зафиксируйте четкую цель разработки документа. Самое худшее что вы можете сделать — разработать “документ ради документа”. У него в обязательном порядке должна быть цель.
-
Зафиксируйте все источники информации. Важно обеспечить доверие к тем данным, которые вы используете.
Адаптация под читателя
Крайне важно осознавать: всё, что мы пишем, предназначено для читателя. Если ваш документ вызывает у него трудности с пониманием — вы не выполнили свою задачу. Помните: качественная документация должна быть понятна даже неподготовленному читателю.
Практики:
-
Обеспечьте единообразие и стандартизацию. Разработайте или следуйте руководству по фирменному стилю вашей компании. Создайте шаблоны документов и используйте единую терминологию.
-
Используйте модульность. Разбивайте сложные концепции на удобочитаемые документы.
-
Проектируйте юридические экосистемы. Думайте не только об отдельных документах, но и их связанности и синхронности.
-
Сложность текста должны быть на уровне чтения восьмого класса. Чем проще написан текст, тем вероятнее что он будет понят читателями.
-
Создавайте пояснительные записки для сложных документов. Если обеспечить простоту текста невозможно, необходимо создать справочный материал, который на простом языке раскроет ключевым моменты документа. Справочный материал должен находиться в том же месте, где и документ.
-
Запрещено использовать фотографии текста. Никогда не используйте сканы или скриншоты текста.
-
Избегайте документов больше 7 станиц. Сотрудники вряд-ли будут читать большой текст.
-
Пишите четкие заголовки. Заголовки глав должны однозначно раскрывать их суть.
-
Придерживайтесь осмысленной последовательности. Порядок прочтения текста должен иметь смысл.
-
Отделяйте разделы строкой. Визуально отделяйте один раздел от другого. Это упростит усвоение текста.
-
Используйте один абзац для одной мысли. Для создания четкой структуры и отсутствия “смысловой каши“ не совмещайте несколько мыслей в одном абзаце.
-
Избегайте абзацев более 6 строк. Если ваш абзац занимает более 6 строк, значит он или перегружен или может быть разделен на 2.
-
Избегайте канцеляризмов, там где это возможно. Избегайте ненужного жаргона или, при необходимости, поясняйте термины прямо в тексте.
-
Избегайте аббревиатур. Избегайте сокращений или приводите их расшифровку рядом.
-
Выделяйте самое важное в начало. Наш мозг лучше запоминает то, что расположено в начале текста.
-
Выделяйте ключевую информацию. Используйте жирное выделение, курсив, подчеркивание или цвет.
-
Используйте визуальные материалы, там где это возможно. Используйте диаграммы, значки, шкалы, блок-схемы и т.д. Показывайте, а не просто рассказывайте. Схемы воспринимаются мозгом лучше чем текст.
-
Размер визуального материала должен быть не менее 500Х500 пикселей. Использование меньшего разрешения усложнит его восприятие.
-
Используйте шрифты без засечек. Выбирайте читабельные шрифты, например, такие как Arial, Helvetica, Montserrat.
-
Используйте не менее 14 размера шрифта. Более крупный текст упростит его восприятие.
-
Используйте списки если необходимо перечисление 3 и более элементов. Сплошное перечисление усложняет восприятие текста.
-
Используйте гиперссылки. Если вы ссылаетесь в тексте на иные пункты, добавьте гиперссылку для упрощения навигации. Назначение каждой гиперссылки должно быть ясно из её текста.
-
Создавайте многоязычные документы. Если в вашей компании говорят более чем на 1 языке, переводите созданные документы.
-
Обеспечьте контрастность текста и фона на уровне более 10. Нужно для комфортного восприятия написанного. Для проверки используйте сайт https://imagecolorpicker.com/color-contrast-checker.
-
Обеспечьте отсутствие фонового визуального шума. Не располагайте позади текста визуальные эффекты.
Реалистичность и достижимость
Каждому из нас знакомы политики и регламенты, которые при прочтении вызывают очевидное понимание: их невозможно выполнить или это экономически неоправданно. Это неизбежно ведет к конфликтам, финансовым потерям и управленческим просчётам.
Такой документ с самого начала обречён стать бесполезным и формальным.
Практики:
-
Используйте итеративное прототипирование. Создавайте последовательные версии документа (прототипы), каждая из которых детализируется на основе обратной связи.
-
Обеспечьте сотрудничество с заинтересованными сторонами. Создайте рабочую группу, которая будет проверять реалистичность требований в прототипах. Включите в рабочую группу представителей заинтересованных сторон.
-
Проведите рецензирование финальной версии документа. После того как финальный документ будет разработан, проведите предварительное согласование заинтересованными сторонами.
Обратная связь
Как и всё в этом мире, документ не может быть идеальным. Постоянное совершенствование — неотъемлемая часть работы с документацией, а улучшения без обратной связи бессмысленны.
Сбор отзывов не только повышает эффективность документа, но и улучшает взаимодействие между всеми заинтересованными сторонами.
Практики:
-
Обеспечьте возможность оставлять обратную связь. Обеспечьте единый интерфейс подачи обратной связи (укажите контактное лицо, форму обратной связи или предусмотрите возможность комментирования или сбора отзывов)
-
Инициализируйте сбор обратной связи. Обеспечьте инициативный сбор обратной связи перед разработкой новой версии документа или 1 раз в заданный промежуток времени.
Поговорим о выполняемости
Следующий вопрос, который я задал себе: как понять, что я эффективно управляю документом? Чаще всего самый простой ответ оказывается самым верным — спросить. Вы можете напрямую обратиться к человеку, для которого этот документ предназначен; однако, чтобы обратная связь не была хаотичной, я подготовил перечень вопросов, который вы можете использовать.
Вопросы
Прозрачность и доверие
-
Я знаю где лежит документ
-
Я могу получить беспрепятственный доступ к документу
-
Я уверен/на что мне доступна последняя версия документа
-
Я знаю кто разработал документ
-
Мне не нужно скачивать дополнительное программное обеспечение чтобы открыть документ
-
Цель документа четко сформулирована и понятна
-
Документ имеет введение, объясняющее контекст
-
Содержание соответствует заявленной цели
-
Присутствуют все необходимые ссылки на источники
-
Все требования документа понятны
Адаптация под читателя
-
У документа есть чёткая, логично построенная структура
-
Идеи в разных частях текста не повторяются
-
Документ нельзя сократить без потери смысла
-
Документ не уходит в нерелевантные детали
-
В документе достаточно примеров/иллюстраций для понимания
-
Каждый абзац раскрывает одну мысль
-
В документе отсутствуют отклонения от темы
-
Документ легко читать
-
Документ можно прочитать в течение 20 минут
-
Я не теряю фокус при прочтении документа
-
Документ раскрывает одну тему
Реалистичность и достижимость
-
Я принимал/ла участие в разработке документа
-
Требования документа выполняются/могут быть выполнены
-
Документ проходил мое рецензирование
Обратная связь
-
Я знаю как я могу дать обратную связь по документу
-
Ко мне обращались с просьбой дать обратную связь по документу
-
Я знаю, кому я могу направить обратную связь
-
Документ не требуется дорабатывать
-
Нет информации, которую можно было бы добавить в документ
-
В документе нет ненужных или неинформативных частей
Соответствие
Также, для себя я определил 3 уровня для документов, которые я пишу. Логика определения уровня очень простая и привязана к вопросам выше.
|
Число положительных ответов на вопросы |
Уровень управления документом |
|
Больше или равно 25 |
1 уровень |
|
Больше или равно 15 |
2 уровень |
|
Менее 15 |
3 уровень |
Заключение
В конце хочется сказать — я хочу чтобы документы писались хорошо и поэтому использую ПАРО. Концепция не претендует на ультимативность, и она точно нужна не всем. Вы можете применять ее практики на свое усмотрение, возможно их часть к вам просто не применима.
ссылка на оригинал статьи https://habr.com/ru/articles/936306/
Добавить комментарий