Как написать отличную техническую публикацию в блоге

1656561985 kak napisat otlichnuyu tehnicheskuyu publikacziyu v bloge

Пять шагов от идеи до отшлифованного результата

Я работаю в сообществе с открытым кодом почти 5 лет, создавая и продвигая инструменты для разработчиков, в частности Meteor и Apollo. В то время я обнаружил, что ведение блогов является одним из самых эффективных способов распространения идей.

Подготовка сообщения в блоге не занимает так много времени, как видео или выступление на конференции, но его легко употребить и может охватить множество людей. Я также лично получил массу пользы от письма: это помогло мне организовать свои мысли, учить людей о нравящихся технологиях и провозгласить свое имя.

После публикации моего первого сообщения в блоге в 2014 году я написал 68 сообщений здесь на Medium, некоторые из которых набрали более 50 тысяч просмотров и 1000 поклонников, а также отредактировал много сообщений для своих друзей и коллег. За это время я выбрал несколько стратегий перехода к публикации от концепции к публикации.

В этой статье мы рассмотрим пять основных этапов процесса написания публикации:

  1. Найдите хорошую тему и посвятите ее
  2. Определите свои цели и аудиторию
  3. Иметь начало, середину и конец
  4. Получайте обратную связь и повторяйте
  5. Добавьте последние штрихи: упаковка, публикация и продвижение

Приступаем непосредственно к первому шагу!

1. Найдите хорошую тему и привяжитесь к ней

Вы не можете начать работу над публикацией, если у вас не о чем написать! Когда я говорю с людьми, которые хотят начать вести блог, это часто является их основным блокировщиком.

Самая простая стратегия – писать о том, что знаешь. Если вы потратили много часов, изучая что-либо, и вы думаете, что сможете объяснить это всего за несколько минут, вы будете очень полезны для своих читателей.

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

Вот некоторые типы публикаций, которые вы можете выбрать. Примеры взяты из публикаций, связанных с GraphQL, в блоге Apollo:

  1. Пошаговое руководство для достижения конкретной цели: «Создание прекрасного списка с возможностью прокрутки в React Native с помощью FlatList» или «Упростите свои компоненты React с помощью Apollo и Recompose». Они отлично подходят для читателей, которые хотят войти, сделать что-то и быстро выйти.
  2. Углубленный опрос на определенную тему: Использование нулевого значения в GraphQL или Анатомия запроса GraphQL. Они полезны, если вы ориентируетесь на более заинтересованную аудиторию, желающую выпить чашечку кофе и многому научиться.
  3. Нумерованный список полезных фактов на общую тему: «4 простых способа вызвать API GraphQL» или «5 преимуществ статических запросов GraphQL». Это веселое, легкое чтение, поскольку вам не нужно читать полностью и легко потреблять кусочки размером с укус.

Теперь позвольте мне развеять несколько распространенных проблем:

  1. На эту тему уже есть контент. Не разрешайте этому вас остановить. Даже если о вашей идее уже писали раньше, вы можете поставить на нее собственную точку зрения или определить ее конкретно для своей ситуации.
  2. Моя идея недостаточно интересна. Многие мои друзья и коллеги не пишут, потому что боятся, что их выводы могут быть скучными или очевидными. Это нормальное чувство! Если вы в чем-то эксперт, то, конечно, выводы, о которых вы пишете, будут скучными… тебе. Главное, чтобы люди из вашей аудитории еще этого не знали.

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

49vpFzkVXA9fHTQoMGGDKEnqVDBIY4-eZ8d7
Лампочка – универсальный символ для идей. Джеймс Понд на Unsplash

2. Определите свои цели и аудиторию

Теперь, когда вы знаете свою тему, вам нужна аудитория и цель вашей публикации. Кто будет это читать и что они из этого получат?

Ваша цель должна быть специфический чтобы вы могли сосредоточить всю свою энергию на одной главной идее. Целью этой публикации не могло быть просто «написать о блогах». Мне требовалась более конкретная цель:

  • Аудитория: Люди, желающие начать вести блог, особенно на технические темы, но еще этого не сделали.
  • Цель: Дайте людям конкретный набор шагов и указателей, чтобы они могли приступить.

Получив их, сосредоточьте свою публикацию, удалив все, что не способствует, и избегайте добавления дополнительных деталей только потому, что это связано. Я обнаружил, что относительно краткие сообщения со временем чтения 5-10 минут наиболее успешны.

Знание опыта аудитории позволит вам адаптировать свой текст к имеющимся знаниям, а также поможет определить, как вы должны публиковать и продвигать свое содержимое. Например, я надеюсь опубликовать это на freeCodeCamp, потому что многие люди из моей целевой аудитории уже могут прочитать эту публикацию.

3. Иметь начало, середину и конец

Это дезориентирует, когда пост отклоняется в направлении, в котором вы не ожидали. Повороты сюжета могут быть большим преимуществом в вымышленных новеллах, но проще использовать техническую статью, если вы получите именно то, что ожидаете. Вы можете держать своих читателей в курсе, предоставив своей публикации удобную структуру.

Введение

Первый или два абзаца вашего сообщения либо убедят читателя остаться, либо потеряют внимание. Начните с небольшого контекста, чтобы помочь людям понять, где ваша публикация вписывается в общую картину. Затем расскажите аудитории, что они получат от прочтения вашей статьи. Может возникнуть искушение оставить большое открытие на конец, но будьте осторожны: если у вас нет хорошего крючка, ваши читатели не останутся, чтобы узнать.

Средний

Теперь, когда вы сказали своим читателям, что ждать, дайте им это! Не стесняйтесь вдаваться во все детали, сколько вам нужно и оставляйте на своем пути указатели, чтобы ориентировать людей. Используйте много заголовков, нумерованных списков и форматирования, чтобы помочь людям понять, где они находятся, и позволить им перейти к наиболее интересующему их содержимому.

Вывод

Не просто сужаться в пустоту в конце статьи. Если ваш читатель прошел весь путь, это действительно волнует. Дайте им краткий итог того, чему они научились, похлопайте по спине, чтобы прочесть, и, возможно, даже что-то сделать дальше, если они вдохновятся – призыв к действию.

Формат, который я предлагаю здесь, не самый креативный, и, безусловно, есть другие способы сделать это. Но самый простой способ общения с читателями – это простая структура.

op8670wN9BlN6an-m9qZpZcFbitHwZnDFief
Как и дорожные знаки, структура вашей публикации направляет людей. Барт Анестин на Unsplash

4. Получите обратную связь и повторите

Вы не будете знать, что люди получат от вашего письма, пока они его не прочтут. Именно здесь проверяются ваши предположения о теме, целях, деталях публикации и структуре. Если вы хотите получить хороший результат, вы не можете упустить этот шаг.

Может показаться, что вы навязываетесь, когда просите обратной связи, или вы можете беспокоиться, что он будет отрицательным, но люди более готовы помочь, чем вы ожидаете. Гораздо лучше узнать, как ваша публикация может быть лучше, прежде чем публиковать ее во всем мире. Когда я сочинял эту публикацию, я получил очень ценный отклик, который сделал содержимое гораздо лучше и более целенаправленным.

Что спросить у рецензентов? Мой главный совет – оставить его как можно более открытым. Старайтесь не объяснять заранее, чего вы хотели добиться. Сдайте черновик как есть и спросите своего рецензента, что он получил от него или что следует изменить. Когда кто-то в Интернете найдет вашу статью, у них не будет дополнительного контекста, и она должна стоять самостоятельно.

Главное, что нужно подтвердить на основе отзывов: достигнет ли эта публикация целей, которые вы решили на шаге 2? Повторяйте, пока не будете уверены, что так будет.

5. Добавьте последние штрихи: упаковка, публикация и продвижение

Теперь, когда у вас есть идея, цель, структура и некоторые отзывы, пора все отшлифовать и отправить.

Упаковка

Придумайте замечательный заголовок и подзаголовок и убедитесь, что в вашей публикации есть по крайней мере одно изображение. Это то, что люди увидят, когда публикация будет опубликована в Twitter или Facebook и это ваш шанс заинтересовать людей чтением.

Также важно, чтобы ваша публикация выглядела профессионально, чтобы ваше содержимое действительно сияло. Вы должны стремиться, чтобы в вашей публикации не было орфографических ошибок, грамматических ошибок или странного форматирования. Если у вас есть друг, прекрасно обнаруживающий мелкие детали, попросите его прочитать его перед публикацией.

В статье freeCodeCamp о публикации также есть несколько замечательных советов по стилю и форматированию. Поскольку вы уже вложили так много работы в свою публикацию, стоит приложить несколько дополнительных усилий, чтобы действительно отшлифовать ее и расширить охват.

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

Публикация

Вы почти готовы! Выберите место, где вы действительно публикуете сообщение, чтобы он имел наилучшие шансы охватить вашу аудиторию. Средний, как правило, является отличным местом для технического содержимого, и позволяет людям легко найти текст.

Чтобы получить бонусные баллы, попробуйте разместить свой пост в соответствующей публикации, которая поможет поделиться вашим содержимым – в этом случае я выбрал freeCodeCamp, потому что я думаю, что этот совет будет актуален для их читателей. Если вы хотите сделать то же, вот их указания по поводу отправки вашей публикации. Публикации в ваших областях интересов также ищут публикации, поэтому не бойтесь связываться!

продвижение по службе

После того как вы фактически опубликовали сообщение, вы еще не закончили! Если вы хотите, чтобы люди увидели то, что вы написали, и извлекли из этого пользу, не забудьте поделитесь этим в местах, где ваша аудитория, вероятно, будет встречаться. Это может включать в себя группы Facebook, Reddit, Hacker News, LinkedIn или любую другую платформу. Также не забудьте поделиться своим творением в своих аккаунтах в социальных сетях, таких как Twitter. Вашим друзьям будет интересно прочесть, поделиться и проголосовать за то, что вы написали!

И теперь вы кончили. Сходите на кофе или прогуляйтесь – опубликовать сообщение в блоге от начала до конца – это не так уж мало. Прочтите любые отзывы и ответы от сообщества, чтобы продолжать совершенствоваться. А когда у вас появится другая идея, сделайте это еще раз!

lMYImUN-AHrgvCD74GhFaHyXGkIa6L0zP15z
Красивая подача может улучшить и без того вкусный пончик. Зак Майлз на Unsplash

Практике нет замены

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

Оставлю вам последний совет. Главное, чему я научился по ведению блога за последние 3 года, это то, что я абсолютно не могу предсказать, какой контент будет популярнее, а что в конечном итоге станет банальным. Иногда я положу несколько дней на пост, полируя каждый уголок, и это никуда не денется. Не считая того, «GraphQL vs. REST», мой самый читаемый пост, был написан через несколько часов поздно вечером.

Так что даже если ваша первая, вторая или третья публикация не удалась, продолжайте пробовать что-то новое, излагайте свои идеи и усовершенствуйтесь со временем. Мир хочет услышать, что вы должны сказать. Иди скажи им!

Огромное спасибо Анвиши Пай, Анжели Чжан, Кэти Сигел и редакторам freeCodeCamp за помощь в просмотре этой публикации.

Добавить комментарий

Ваш адрес email не будет опубликован.