Айтишник PRO • Путь технического писателя
145 subscribers
12 photos
2 files
16 links
Авторский канал о профессии «Технический писатель» в IT.

Вы узнаете: что изучать, чтобы получить востребованную профессию, как правильно составить резюме и портфолио, чтобы устроиться на удаленку и вырасти до сеньора.

Автор/консультации → @mironyukdk
Download Telegram
Год назад я брал интервью у молодого парня, который запускал IT-стартап. В планах было опубликовать статью на vc, но в итоге стратегию продвижения решили изменить и материал так и остался пылиться на компьютере.

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

Читайте здесь: https://matomba.info/iz-frontenda-v-biznes-kak-eks-razrabotchik-osnoval-startap-na-it-specialistah-be874d74
👍3
Как остановить печатный станок и пойти спасть?

Как обычно в 20:00 я купаю малышку дочку и отдаю жене укладывать на сон, а сам иду в душ. Когда прихожу, меняемся с супругой — сажусь у кроватки ребенка, если она еще не уснула, и кладу рядом с ней руку. Доча ее то обнимает, то теребит маленькими пальчиками, а я читаю вслух книгу или просто успокаиваю, тихо нашептывая колыбельный ритм. Через 15-20 минут малышка засыпает, и я сажусь за ноутбук 👨🏼‍💻

Каждый раз наивно думаю, что напишу еще один абзац или сделаю ревью по-быстрому и пойду отдыхать. Вот вроде было 22:00, поднимаю глаза — на часах 00:00... Говорю себе — «Сейчас еще два предложения допишу и спать», снова поднимаю глаза — 00:15 — «Если сейчас брошу, завтра потеряю мысль, нужно дописать, минут 10 еще, не больше». И так я могу откладывать несколько итераций, пока не наступит 1-2 часа ночи 🌛

Утром конечно никогда такого не было, что я не мог встать, но все равно постоянно себя ругаю🤦🏼‍♂️ Только не могу понять, как характеризовать такое явление — может это именно то дело которым горю и поэтому не могу оторваться и пойти спать или просто вредная привычка? Дисциплина? Пока не понял, как с этим бороться🤷🏼‍♂️ У кого было также, поделитесь как справились?

п.с. сейчас 00:15 — сижу пишу этот пост😆
❤4
И швец, и жнец, и на дуде игрец
или по-простому — «И портной, и крестьянин, и актер».

На днях получил предложение на подработку: писать 2 статьи в месяц в it тематике, 10к за статью, оплата на р/c самозанятого.

Пообщался с представителем компании, обсудили условия, на первый взгляд все адекватно и интересно. Прислали тестовое задание (скрин см. ниже). И тут я понимаю, что компания решила хорошо так сэкономить. Как бы 10к за статью в it еще норм, если есть тема, есть цель текста и ТЗ. Но, когда просят еще провести анализ рынка и выявить актуальные темы, то попахивает нае@ловом. С таким запросом вам либо в маркетинговое агентство, либо брать контент-маркетолога, либо поднимать чек до 20к хотя бы.

Теперь по самому заданию

1. С более странной задачей еще не сталкивался — выберите «любую» из «любого», что?? Это тоже самое, когда тебя просят прислать 3 твоих лучших статьи, а ты им кидаешь список всего, что ты писал когда-либо и говоришь «выбирайте любую».

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

3 и 4 задания самые адекватные
единственное смущает формулировка «подготовьте лид», но тут ладно, можно уточнить заказчика, как я понимают имеют ввиду цепляющий заголовок.

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

Что думаете?
🤔2👍1
#Будни_технических_писателей

В одном из чатов техписателей задали вопрос про синтаксис Sphinx (см. скрин).

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

Ответ на вопрос:

:command: — директива для выделения в тексте отдельных команд или командных строк.

Пример:
Выполните команду :command:ls -l для вывода списка файлов в длинном формате.

:program: — директива для обозначения названия программы или утилиты в тексте документации.

Пример:
Инструкции по установке и использованию :program:Sphinx описаны в документации.

Хотите больше узнать про Sphinx и про работу технических писателей? Нужны ваши реакции 🔥
🔥7
Я, как ошпаренный, бросил телефон в сторону и рванул к ноутбуку. Новая идея прошибла меня, словно током.

Уже 2 года я пытаюсь создать интересный канал и публиковать полезные материалы. Это был канал про VoIP и телефонию, потом про сети, про карьеру в IT для начинающих, про успех и саморазвитие, но все они заканчивались через 2-3 месяца.

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

🤔 И вот я лежу, отдыхаю после трудового дня, листаю ленту в ТГ и вдруг приходит мысль: а что если брать интервью у интересных людей?

Но где их найти? Кто захочет просто так тратить свое время? О чем спрашивать и какую тему поднять?

Я открыл ноутбук и начал искать ответы. Об этом расскажу позже.

Спойлер: скоро вас ждет супер материал от крутого и опытного эксперта в контенте 🔥
🔥5
Начало лета конечно удивило😃 Такая жара стоит... ☀️☀️☀️

В прошлом году, помню, только пару раз надевал шорты и сланцы, а сейчас начало июня ,и мы уже изнываем от жары. Но в любом случае, я очень люблю лето. Также, как и работу с текстами, несмотря на инженерную специальность. Было время, когда писал статьи на Habr — крупные компании и IT-стартапы заказывали у меня маркетинговые спичи.

Это был интересный опыт, но все равно не то. Мне хотелось сделать комьюнити, собрать единомышленников. И вот меня осенила мысль делать живые интервью. Как и обещал, расскажу в этом посте, что я придумал.

Мне было непонятно, где искать респондентов, было страшно написать им — а вдруг откажут, проигнорят или пошлют куда подальше?

Как я решил эти вопросы:

0️⃣ вспомнил про сервис «Хабр.Эксперты» и нашел там 5 интересных людей;
1️⃣ заранее составил обращение, использовал всякие приемы из маркетинга, чтобы привлечь внимание и вызвать интерес ))
2️⃣ написал, договорились о времени, обговорили примерные вопросы;
3️⃣ созвонились в Zoom.

▶️ Скоро выйдет материал в виде подкаста и лонгрида! Следите за анонсами.
🔥5
Все оказалось проще, чем я себе это представлял. Думал нужно будет написать всем 5 экспертам. Но решил сначала выбрать двух самых топовых, которые мне понравились и отправил сообщения. И вот, буквально через час, первой откликнулась Екатерина. Я был приятно удивлен. Это очень круто, что люди готовы делиться опытом 🔥

Катя, тебе привет 👋 Выпуск уже в работе, отдал на звукообработку и пишу потихоньку пишу ))
🔥4
[Подкаст] Как копирайтеру зарабатывать от 80 тысяч в месяц на фрилансе?

Катя 7 лет работает в контенте. За это время прошла путь от наемного сотрудника до фрилансера и обратно. Она поделилась своей историей и рассказала, как находила заказчиков, сколько зарабатывала, как нашла работу мечты и почему решила вернуться в найм.
👏2
Я тут потерялся аж на 5 месяцев.

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

Еще у меня снова появилось вдохновение писать на Хабр и вести ТГ канал. Напишу обо всем подробнее в следующем посте. Хочу сделать его приветственным и закрепить сверху страницы.

Теперь планирую писать регулярно — два-три поста в неделю. Ставьте 🔥, если интересно. И спасибо за поддержку!
🔥6
Дэвид Огилви — великий копирайтер всех времён сказал такую фразу⬇️

«Стремясь достать звезды, вряд ли поймаешь хоть одну, но и не зачерпнешь пригоршню грязи…»

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

Кто я и о чем пишу?👨‍💻

Привет! Меня зовут Дмитрий. Я технический писатель, а еще муж, отец и айтишник. Живу в Сибири, а работаю удаленно в Москве. В IT с 2016 года. За это время успел вырасти до руководителя, потом выгорел, хотел все бросить, но остался. Правда уже не инженером, а писателем.

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

Вам знакомо ощущение, будто занимаешься не тем делом? Вроде бы доход устраивает и получается неплохо, но все равно что-то гложет изнутри. Такое ощущение, будто ещё есть запас энергии и потенциал, но текущая деятельность не дает использовать ресурсы на все 100%? У меня так было несколько лет. Я постоянно менял направления в IT: то внедрял, то программировал, то администрировал, то руководил. Но нигде не нашел себя. В итоге это ощущение настолько съело меня, что я решил бросить IT.

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

Однажды я написал статью на Хабр, и она быстро вышла в топ. Тогда мне захотелось написать еще, потом еще и еще. Вскоре, ко мне стали обращаться IT-компании, которые просили писать за деньги. Такая перспектива мне нравилась, и я подумал, почему бы не уйти в тексты?

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

Я искренне полагал, что с техническим образованием и опытом работы в IT, меня возьмут с распростёртыми объятиями. Но к большому удивлению, работодатели спрашивали гуманитарное образование 🤷‍♂️

Полтора года я работал над повышением писательского скилла и формировал портфолио. В итоге, после 20-й попытки, всё таки смог устроиться на новую должность.

Меня взяли в крупную IT-компанию в Санкт-Петербурге. Где я работал старшим техническим писателем. А сейчас работаю в Московской фирме. Разрабатываю пакет документации к IT-системам, которые мы создаем для автодилеров и импортеров. Работа сложная и интересная, а самое главное творческая. Ведь, чтобы получить красивый и понятный пользователю документ, нужно собрать информацию о системе с разных источников, разобраться и изложить в доступном виде. Это целое искусство! Невероятное удовольствие испытываешь, когда проделал огромную работу и получил на выходе полезный артефакт😎

Как оказалось, в России профессия «технический писатель» ещё очень молодая и непопулярная. Она только-только набирает обороты. Поэтому и специалистов не так много.

Я завёл канал, чтобы рассказать как можно большему количеству людей об этой интересной профессий в мире IT.

Мой канал стоит почитать, если вы:
▫️Копирайтер.
▫️Студент.
▫️Джун.
▫️Технический писатель.
▫️Тестировщик.
▫️Бизнес/системный аналитик.
▫️Или специалист любой другой профессии, связанной с текстами.
🔥6💯1
Как общаться с иллюстратором/дизайнером?

Раньше при написании статей я не имел дело с иллюстраторами. Накидывал креативы сам. Находил что-то интересное в интернете и изменял под себя в Canva.

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

«Мне непонятна не идея статьи, не формулировка идеи для иллюстрации...»

Я искренне полагал, что иллюстраторы, прочитав текст, могут сгенерировать миллион идей и предложить автору статьи на выбор. Потом мы бы вместе докрутили до идеала.

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

Не знаю, может это дизайнер у нас такой, или они все такие, или просто я такой отсталый в этом плане 🤷🏼‍♂️
🔥3
3 ключевых навыка успешной карьеры техписателя

1️⃣Критическое мышление.
Не верьте никому, пока сами не проверите. Если аналитик пишет в техническом проекте, что поле имеет тип DATETIME, перепроверьте в самой базе данных, там легко может оказаться тип TIMESTAMP.

2️⃣Декомпозиция цели.
Разбивайте большую задачу на мелкие. Вот вы решили поклеить обои в комнате, вы же не сорветесь в ту же секунду покупать и замешивать клей? Сначала прикините сколько рулонов нужно, подумаете, как расставить мебель на время ремонта, выберите обои, оторвете старые и так далее. Также и с рабочими задачами.

3️⃣Умение действовать.
Определили мелкие задачи для достижения большой цели, осталось самое важное — действовать! Сделайте первый шаг прямо сейчас. Второй пойдёт легче.

Вообще, эти три компонента помогут достигнуть успеха в любом направлении. Не обязательно только техписателям.
Please open Telegram to view this post
VIEW IN TELEGRAM
👍4🔥2
Почему страдательный залог заставляет читателей страдать?

Деньги потрачены, документ прочитан, программа протестирована, бутерброд хищно съеден —  во всех фразах подлежащее не выполняет действие, а испытывает его на себе. Это и есть страдательный залог. Но что же в нём плохого?

⚠️Проблема в том, что в тексте появляется неясность: кто же на самом деле выполняет действие?

Если это просто бутерброд — ну съеден он да съеден, а если это большой вкусный сэндвич, который вы сделали утром и принесли на работу? Вот вы решили пойти на перерыв. Заварили кофе, открываете холодильник, а сэндвича нет, он был кем-то беспощадно съеден. В таком случае субъект действия очень даже важен 🤨

❗️Также и в технической документации.

Вот самый простой пример:
«Перед обработкой файла создается его резервная копия».

❓У читателя возникнет вопрос: резервная копия файла создаётся кем, системой или администратором?

1️⃣Вполне может быть сценарий, что перед тем как запустить процесс отработки файла, администратор должен сделать его копию.

2️⃣А может и быть ситуация, что администратору требуется только запустить процесс обработки, а система уже сама сначала создаст копию файла и только потом начнёт обработку.

😀 Тогда как написать правильно?

В 1️⃣случае пишем:
«Перед обработкой файла создайте его резервную копию».

Во 2️⃣:
«Перед обработкой файла система создаёт его резервную копию».

Согласитесь, с такой формулировкой не возникает никаких вопросов ▫️

❌ Допускать в технической документации неясности — это категорически непозволительная роскошь. Я бы даже сказал: грубейшая ошибка!

Посмотреть больше примеров со страдательным залогом можно в статье моего коллеги.
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥4👌1💯1
Вопрос с иллюстратором решился

В предыдущем посте рассказывал ситуацию про отрисовку обложки для новой Хабр-статьи.

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

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

А иллюстрацию покажу после выходных, когда будет опубликована моя статья 🕺
Please open Telegram to view this post
VIEW IN TELEGRAM
👏3👍2
📌 О КАНАЛЕ

Привет! Меня зовут Дмитрий, я технический писатель senior в крупной российской IT-компании.

❗️На канале я выкладываю весь свой опыт в IT. Рассказываю, как получить востребованную IT-профессию, если не хочешь программировать.

Вы узнаете:

🔺Что из себя представляет профессия «Технический писатель», и почему это перспективно.

🔺Какие задачи выполняет техписатель.

А также расскажу:

🔠 интересные задачи из моей практики.

Техписатели, примерно как и программисты, зарабатывают от 100 до 250+ тысяч в месяц и работают удаленно.

Но я не буду рассказывать сказки про легкий путь, как быстро ворваться в IT с нулевым опытом, работать под пальмой и зашибать бабки. Нет, на моем канале только правда.


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

Подписывайтесь⬇️ А если хотите получить консультацию → пишите в личку @mironyukdk
Всем рад помочь!
😌
🔥3👍1