Описание задач

Не думала что будет повод в канале по аналитике и автоматизации написать про текст, но вот появился)
Я сейчас просматриваю большое количество описанных аналитиками #ForPeople задач для разработчиков и очень явно видно как у каждого аналитика есть свой стиль описания. Надо признаться, что я легко воспринимаю тексты, написанные в стиле, похожем на мой, и мне крайне сложно воспринимать задачи, написанные по другому.

Кстати, посты в телеграме тоже разные авторы пишут по разному.
Не знаю, заметили вы или нет, но в постах я постоянно:
* использую маркированные списки
* разделение на абзацы
* делю посты по темам (один пост — одна мысль)
* делаю ссылки на похожие посты,
в общем, всячески структурирую информацию.

Это не потому что так учат эксперты по развитию каналов в телеграм, а потому что на уроках русского языка в 5 классе меня учили начинать писать сочинение с составления плана, ну и, потому что такой ход моих мыслей и мне самой так удобно (надеюсь, что вам тоже :).
А если бы в телеграм была возможность, то большинство моих постов были бы в виде табличек :))

И я очень-очень рекомендую всем бизнес-аналитикам использовать в описании задач похожие принципы оформления текста.
У целевой аудитории задач (разработчиков) нет возможности прочитать текст задачи по диагонали, им обязательно нужно:
* вникнуть в содержание,
* понять ключевые идеи,
* реализовать то, что описано и
* достигнуть поставленной цели

Так что описание задачи — это не просто текст, а еще и хорошо оформленный текст.