Инженерам иногда приходится писать инструкции, короткие технические статьи, готовить рассказы для презентаций и воркшопов, с объяснением того или иного рекомендуемого решения. При подготовке таких рассказов и статей сразу возникают вопросы: о чем писать, сколько писать, что рассказать, а что опустить.
У профессиональных писателей и редакторов есть шаблоны и заготовки текстов на различные темы. Попробуем собрать здесь ссылки на лучшие рекомендации в помощь тем, кто пишет технические статьи или рассказы.
Конечно же ничего идеального не бывает, кроме "золотого сечения" и числа π :) Но следующие рекомендации могут вам пригодиться как для подготовки каркаса для технической статьи, так и для рассказа на воркшопе или вебинаре.
Каким может быть каркас (структура) технической статьи или рассказа:
- Технические проблемы, которые будут разобраны или решены в статье (или в рассказе на воркшопе).
- Выбранные для решения инструменты, технологии или методики. На что опирались при выборе способов решения, какие метрики и целевые показатели для оценки итогов решения выбирали.
- Описание того, как внедряли инструмент или реализовывали техническое решение. Расскажите о процессе решения, разработки инструмента, использовании технологии или методики.
- Итоги внедрения: к чему пришли, оценка значений метрик и какая экономия получена.
- Описание того, какие выявлены ограничения инструмента, технологии или методики в процессе решения.
- Предложения, как можно улучшить и доработать предлагаемое решение в будущем.
- Выводы, краткое резюме и основные мысли статьи или рассказа.
Приведём также один пример готовой структуры для написания вообще любой статьи (взято отсюда). Как пишет сам автор: "По ней можно написать пост, даже если вы считаете, что не умеете писать" :)
Сервисы:
- Сервис Главред: проверит стилистику и грамотность текста.
- The Rules: "Правила русского языка. Проверка орфографии и пунктуации".
Советы:
- Как начать писать лучше? Главред: Советы и статьи о тексте, редактуре, информационном стиле и рекламе (см. раздел для начинающих).
- Конечно же "Новые правила деловой переписки"
- Рекомендации по подготовке презентаций и как готовиться к докладу: "Точка контакта: презентация".
- DO IT INBOUND: "Готовая структура для разных типов статей"
- "Как написать простое и понятное объявление".
- Бюро: "Почему НЕ НАДО ПИСАТЬ КАПСОМ" и как лучше.