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

1. Исследуйте и делайте заметки (делайте дело)

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

Прежде чем вы сможете стать учителем, вы должны делать дело, что бы это ни было. Мне вспоминается часто цитируемая цитата Эмерсона:

«Делай дело, и у тебя будет сила».

Ральф Уолдо Эмерсон

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

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

2. Создайте план из заметок

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

Говоря о которых…

3. Напишите статью

Время наконец пришло. Наденьте теплые носки, сядьте за стол и устройтесь поудобнее — пора писать!

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

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

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

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

4. Пересмотреть

Статья написана! Ура!

Итак, вы закончили, верно? Время упаковать его?

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

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

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

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

5. Опубликовать

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

«Единственная цель начать — это закончить, и хотя проекты, которые мы делаем, никогда не заканчиваются, они должны быть отправлены».

Сет Годин в фильме Опора

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

Следующие шаги

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

Когда вы попробуете этот метод, пожалуйста, дайте мне знать. Может быть, вы откроете для себя несколько новых шагов, о которых я не знал. Не забудьте поделиться своими выводами (и недавно опубликованной работой) в комментариях.

Вам нравится изучать программирование и вычислительную технику? Если да, то PageKey Solutions — это то, что вам нужно! Нажмите здесь, чтобы посетить.

Первоначально опубликовано на странице blog.pagekeysolutions.com 13 декабря 2018 г.