Недавно, две статьи назад, в нашем корпоративном хабе вышла сотая статья. В честь круглого числа мы решили немного обобщить наш опыт. В этой статье расскажем, как работают над статьями наши разработчики, что помогает им писать и на что обращать внимание в работе над текстом.
Для начала достаточно ответить на два простых вопроса:
После чего можно взять план из этой статьи (или придумать свой) и сделать это.
Есть творческие этапы и технические. В этой статье поговорим о творческих. Рассмотрим:
Надеемся, что текст пригодится и другим авторам Хабра, в том числе потенциальным.
Единого ответа и серебряной пули нет. Поэтому приведем ответы наших сотрудников, где каждый может узнать себя, и с удовольствием послушаем, как у вас.
При выборе тем мы ориентируемся на наш субъективный опыт и практические кейсы, которые прошли и проверили сами. Конечно, предполагается, что мы заранее изучили литературу и не будем повторять то, что уже написано. А ещё по правилам хорошего тона всегда ссылаемся на полезные источники.
Хорошо то, что приносит пользу, экономит время в будущем у читателей и дает практический опыт, а не философские измышления о мире во всем мире.
Таких есть великое множество, но упомянем некоторые из них:
В общем плохо всё, что не несет пользы читателю или его не уважает.
Для автора работа над текстами проходит через 6 созидательных этапов:
Очередность этих этапов — не строгая. Случается, что автор первым делом составляет план, раскрывает каждый пункт и детализирует до нужного уровня, затем правит текст в несколько итераций. А бывает, что сперва разработчик конспектирует решение рабочей задачи, и уже на этой основе рождается текст для Хабра. На любом этапе к статье могут подключиться другие коллеги, которые помогут идеей или советом.
А теперь от планов — к действию. То есть к тексту.
Работа над текстами в стиле «отдодвинул все задачи и ушёл с головою» у нас не складывается из-за bus factor. Поэтому авторы понемногу занимаются статьей в фоне остальной работы. Зачастую текст является конспектом актуальной рабочей задачи.
Один из наших авторов сравнил эту работу с тестами. Сначала думаешь, что нет времени писать тесты. Потом встраиваешь эту деятельности в процесс – и получается, что время есть. Тексты, как и тесты, помогают в понимании происходящего. Даже если выделять на статью по часу в день, она получится. Разумеется, в случае, если для человека это важно.
Другой пишет строго по утрам. Первым делом. Зная, что у него впереди куча основной работы, он может потратить на текст 20 минут с самого начала рабочего дня. В таких условиях получается писать четко, кратко и по делу.
Ничего нового в этой проблеме нет. Стивен Кинг, Джордж Оруэлл, Эдгар Аллан По, товарищи Стругацкие, дуэт Генри Лайон Олди, Ричард Фейнман и многие другие авторы в той или иной формулировке говорили:
Одним из нас помогает открыть текстовый редактор и вылить туда поток мыслей по теме. Скорее всего, потом окажется, что это «всё не то», но первый шаг сделан — работа над статьей началась.
Есть и другой способ: найти другого сотрудника и рассказать ему о теме статьи. Причём начать рассказ со слов: «Ну, короче…». И как только полились первые мысли, с криком «Спасибо!» убежать к себе и срочно записать свой рассказ. Простыми словами, с производственными матами, который вы потом замените на что-то конструктивное.
И на закуску способ от классика — строго под вашу ответственность.
Есть три варианта развития событий, который можно приложить к ситуации:
Если у вас есть другие варианты, как выйти из творческого ступора — делитесь в комментариях.
Пишите. Никого не слушайте и пишите. Это хорошо. А хорошо будете писать – вообще отлично. И тогда хаброобщество будет умнеть, матереть и богатеть.
Напоследок полезные ссылки на эту тему:
Делитесь своими рецептами в комментах, ждем!
Для начала достаточно ответить на два простых вопроса:
- Зачем это мне?
- Что я расскажу интересного и полезного хабраобществу?
После чего можно взять план из этой статьи (или придумать свой) и сделать это.
Есть творческие этапы и технические. В этой статье поговорим о творческих. Рассмотрим:
- Зачем писать статьи,
- Откуда взять тему для статьи,
- Где найти время, чтобы её написать,
- Основные этапы работы над текстом,
- Что делать, если статья «не идёт»,
- И с чего начать, если ты ни разу не писал на Хабр.
Надеемся, что текст пригодится и другим авторам Хабра, в том числе потенциальным.
Мотивация: зачем мне, разработчику, писать на Хабр
Единого ответа и серебряной пули нет. Поэтому приведем ответы наших сотрудников, где каждый может узнать себя, и с удовольствием послушаем, как у вас.
- Социализация
Мотивирует сопереживание и чувство общности — хочется поделиться эмоциями и мыслями о процессе разработки с заинтересованным сообществом. - Систематизация своих знаний
Нравится порядок в своей голове, а написание статьи или вообще итогового текста позволяет многократно ускорить нахождение пробелов в понимании и знании о теме. Статья позволяет посмотреть на тему с разных сторон, до конца выяснить все непонятные моменты, реализовать что-то. - Интерес разобраться в новом и поделиться
Мотивирует писать про что-то новое для себя, про то, что свежо в мире разработки. Если бы я занимался типичными задачами, то не думаю, что с этого был бы какой-то выхлоп. По большому счету, на выходе получается инструкция с прибаутками или без, которая напоминает развернутый ответ со Stack Overflow по вопросу/теме, заданной в заголовке статьи. - Экономия времени на обучение внутри
Статья как конспект для своих коллег, которым всё равно предстоит это потом рассказывать. А так написал — и разослал или провёл семинар. - Получение обратной связи и комментариев общества
Просмотры и плюсики в зачетку получать довольно приятно, улучшает карму. Улучшенная карма также мотивирует писать дальше. В комментариях можно почерпнуть для себя полезную информацию от ребят, которые пошли той же дорогой и уже набили шишек. - Ради всего хорошего
Вдохновляет желание ускорить развитие человечества — если любая деятельность автора сэкономит людям больше времени, чем он потратил — в среднем человечество скорее всего выиграет в развитии, поскольку сэкономленное время будет вероятно потрачено на полезную деятельность.
Выбор темы с учетом полезности для Хабра
При выборе тем мы ориентируемся на наш субъективный опыт и практические кейсы, которые прошли и проверили сами. Конечно, предполагается, что мы заранее изучили литературу и не будем повторять то, что уже написано. А ещё по правилам хорошего тона всегда ссылаемся на полезные источники.
Хорошие темы
- Бывают решения, про которые разработчики говорят: «В официальной документации про это не было, на Хабре тоже. Пришлось повозиться». Если само решение достойное, значит, и статья будет хорошей.
- Некоторые темы вытекают из глобальной задачи, которая поставлена на проекте – например, обеспечить High Availability и прозрачный CI/CD. Каждый шаг на пути к этой цели – миграция на .Net Core, Docker и так далее – может быть описан в отдельной статье. На митингах частенько проскакивает шутка «в статью!», т.е. коллеги как бы намекают.
- Часть тем приходит, когда ты активно исследуешь новую тему. Есть примета: если разработчик потратил на исследование больше 4 часов в Google или на чтение других статей – значит, стоит сделать хотя бы компиляцию найденной информации, а может, и написать что-то новое.
- Некоторые тексты рождаются после прочтения интересной книги, посещения хорошей конференции или даже как внутренняя документация — хочется поделиться новыми знаниями.
Хорошо то, что приносит пользу, экономит время в будущем у читателей и дает практический опыт, а не философские измышления о мире во всем мире.
Плохие темы
Таких есть великое множество, но упомянем некоторые из них:
- Повтор всем известного с единственной целью проиндексироваться по ключевым словам,
- Прямая или косвенная реклама компании или клиента (смотрите, с кем я работаю),
- Статья ни о чем или бесструктурный поток мыслей.
В общем плохо всё, что не несет пользы читателю или его не уважает.
Основные этапы работы над текстом
Для автора работа над текстами проходит через 6 созидательных этапов:
- Целеполагание: формулирование темы, идеи и плана. Чтобы нащупать тему, мы отвечаем на вопросы «Что нового читатели узнают из этой статьи», «Для кого мы её пишем», «Чем именно хотим поделиться». Ещё нам важно, чтобы статья привносила что-то новое. Для этого смотрим по ключевым словам, что уже написано на эту тему и не повторяемся ли мы.
- Заметки, или лабораторный журнал. В ходе работы над задачей разработчики делают заметки: сохраняют полезные ссылки, записывают якоря-напоминалки по нештатным ситуациям, чтобы затем можно было от-реверс-инжинирить заметки в читаемый текст. Когда доходит до текста, остаётся только перечитать «лабораторный журнал», переформулировать некоторые записи с использованием более-менее общепринятой лексики, а потом собрать в логичном порядке.
Один из наших авторов использует онлайн markdown-редактор hackmd.io, где фиксирует свои шаги в разработке темы. Этот инструмент позволяет расшарить текст, показывать прогресс по статье, а главное — заранее сверстать её. В итоге получается текст, в который для публикации на Хабре достаточно добавить кат и придать пару мелких штрихов. Это удобно, чтобы контролировать структуру и верстку текста.
- Упорядочиваем текст. Выписываем главные мысли и смотрим на их полезность и место в структуре статьи. Получается оглавление, то есть кластеризация текста на смысловые блоки, которые можно воспринимать, даже не читая другие разделы.
- Редактируем и правим, чтобы посторонний человек «не в теме» мог более-менее понять смысл сказанного. Можно каждый день хотя бы раз перечитывать написанное и править то, что не нравится. Правка идёт в несколько итераций, как и работа над текстом. На этом этапе смотрим на язык и ошибки — непроверенный текст читается так, словно написан школьником-двоечником.
- Смотрим на текст чужими глазами: статью читает другой разработчик или PM, компетентный в этой теме. Свежий взгляд и конструктивная критика улучшают продукт.
- Готовим текст к печати. Вносим финальные правки, продумываем иллюстрации, выбираем подходящие хабы — и в печать!
Очередность этих этапов — не строгая. Случается, что автор первым делом составляет план, раскрывает каждый пункт и детализирует до нужного уровня, затем правит текст в несколько итераций. А бывает, что сперва разработчик конспектирует решение рабочей задачи, и уже на этой основе рождается текст для Хабра. На любом этапе к статье могут подключиться другие коллеги, которые помогут идеей или советом.
А теперь от планов — к действию. То есть к тексту.
Очень много задач: как найти время для работы над текстом
Работа над текстами в стиле «отдодвинул все задачи и ушёл с головою» у нас не складывается из-за bus factor. Поэтому авторы понемногу занимаются статьей в фоне остальной работы. Зачастую текст является конспектом актуальной рабочей задачи.
Один из наших авторов сравнил эту работу с тестами. Сначала думаешь, что нет времени писать тесты. Потом встраиваешь эту деятельности в процесс – и получается, что время есть. Тексты, как и тесты, помогают в понимании происходящего. Даже если выделять на статью по часу в день, она получится. Разумеется, в случае, если для человека это важно.
Другой пишет строго по утрам. Первым делом. Зная, что у него впереди куча основной работы, он может потратить на текст 20 минут с самого начала рабочего дня. В таких условиях получается писать четко, кратко и по делу.
Хочу написать статью на Хабр и даже тему придумал. С чего начать?
Ничего нового в этой проблеме нет. Стивен Кинг, Джордж Оруэлл, Эдгар Аллан По, товарищи Стругацкие, дуэт Генри Лайон Олди, Ричард Фейнман и многие другие авторы в той или иной формулировке говорили:
«Если вы хотите что-то начать (писать статью, книгу или письмо другу), но все никак не можете — нет времени и ситуации лучше, чтобы сделать это, чем… прямо сейчас!».
Одним из нас помогает открыть текстовый редактор и вылить туда поток мыслей по теме. Скорее всего, потом окажется, что это «всё не то», но первый шаг сделан — работа над статьей началась.
Есть и другой способ: найти другого сотрудника и рассказать ему о теме статьи. Причём начать рассказ со слов: «Ну, короче…». И как только полились первые мысли, с криком «Спасибо!» убежать к себе и срочно записать свой рассказ. Простыми словами, с производственными матами, который вы потом замените на что-то конструктивное.
И на закуску способ от классика — строго под вашу ответственность.
Пишу, пишу, застрял. Что делать?
Есть три варианта развития событий, который можно приложить к ситуации:
- Выпить чайку и расслабиться. Уж точно не нужно себя заставлять, когда текст «не идёт» — ничего хорошего из такого превозмогания не получается. Это, кстати, касается не только написания статей.
Но и забрасывать работу не стоит. Как только чувствуете, что более-менее расслабились — перечитайте написанное, наверняка в голову придёт ещё какая-то мысль. Нарисуйте схемку структуры текста. Закиньте текст коллеге.
Делайте что-то вокруг текста, но не вымучивайте слова. Тогда мысли сами начнут роиться и нужно будет только ухватить их за хвост — и выложить, как есть, на бумагу/в текстовый редактор. - Сгребите весь материал в релиз статьи всё «как есть». В этот момент придется дописать основные мысли или логически завершить с выводом, что есть. Если это выглядит хорошо, то остальное можно сдвинуть в следующую статью.
- Глубокий и длительный ступор может означать, что тема не близка, и писать про неё не надо. Такие темы лучше отсечь на первом этапе. Или посоветоваться с коллегой.
Если у вас есть другие варианты, как выйти из творческого ступора — делитесь в комментариях.
В заключение
Пишите. Никого не слушайте и пишите. Это хорошо. А хорошо будете писать – вообще отлично. И тогда хаброобщество будет умнеть, матереть и богатеть.
Напоследок полезные ссылки на эту тему:
- Статья Mail.ru, как создавать авторский контент для блога компании
- Полезная книга «Пиши, сокращай» и сайт для экспресс-проверки текстов на понятность
- Статья с признаками хорошей статьи
Делитесь своими рецептами в комментах, ждем!
