Выпустила на Виси статью про то, как писать на сложные темы. Там немного подробнее о том, что я уже здесь рассказывала, с парочкой свежих примеров. И шутейками) Заглядывайте, ставьте лайки-комменты и все такое:
https://vc.ru/marketing/590034-kak-pisat-i-redaktirovat-teksty-o-tom-chego-ne-ponimaesh-i-pri-chem-tut-kitayskaya-komnata

#IT_словарь Продакшн

Аналогия. Машину спроектировали, произвели на конвейере тестовую модель, проверили на тест-драйвах, запустили в производство. Момент, когда она появилась в магазинах — и есть «выкатка на прод». А прод — это или момент выпуска, или сам магазин, то есть «среда», в которой продукт доступен пользователям.

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

🏄‍♂️Немного интерактива для тренировки

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

🤖«Еще один момент, которого нам тоже не хватило, это группировка серверов. Наш общий кластер наполняется серверами за счет бюджета проектов и команд. Естественно, они хотят получить гарантию того, что они получают приоритет и могут полностью утилизировать все свои ресурсы. Поэтому были созданы пулы серверов.
(00:15:00)

Есть два типа пула. Первый – это приватный пул, когда этот пул отдан эксклюзивно команде, никакие другие команды не могут запускаться в этом пуле. И есть общедоступный пул, когда сервера в этом пуле могут использоваться любыми членами команды, любыми пользователями в KubeFlow. Для реализации данного подхода был написан Mutation Webhook, который по аннотации в неймспейсе, которая, в свою очередь, наследуется от namespace команды, добавляет в поды необходимые nodeAffinity.»🤖

🎳ТОП-4 вещи, которые НЕ мешают мне нормально работать

Вроде как должны, но ни у кого нет претензий.

⌨️Небезупречная грамотность. Могу опечатываться, пропускать запятые, иногда даже слово пишу не очень правильно. Ошибки некритичные, какие-то исправляет корректор, на какие-то просто пофигу.

🥉Деланье не идеально. Никогда не дошлифовываю ничего до идеала. Нормально получилось — отдаю редактору или заказчику. Что-то поправим, выходит ОК — выпускаем.

🐣Недостаточное понимание темы. Иногда не полностью понимаю, о чем пишу, если тема сложная. Бывает, что ошибаюсь — эксперт правит и никакой трагедии.

🕐Нечеткий рабочий график. Часто беру отгулы на пару дней, из-за разницы во времени с Москвой рано заканчиваю работу. Предупреждаю обо всем заранее, все успеваю, и вроде как норм)

❓А какие вещи у вас в работе вроде бы должны мешать, но не мешают?) Напишите в комменты, интересно.

✈️Ответ на интерактив

В этом сообщении показала оригинал расшифровки вебинара. Вот как его в итоге отредактировали для выпуска:

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

Есть два типа пулов:
— приватный, который отдан эксклюзивно команде — никакие другие команды не могут в нём запускаться;
— общедоступный, серверы в нём могут использовать любые члены команды и пользователи в Kubeflow.

Для реализации этого подхода мы написали Mutation Webhook. От Namespace команды наследуется специальная аннотация в неймспейс пользователя. По этой аннотации Webhook добавляет в поды необходимые nodeAffinity».🤔

🫤Что мы тут сделали?

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

В общем, ничего особенного, но отличия сразу заметны. Совпало примерно с вашими предположениями по редактуре? Может, добавили бы что-то еще?

#IT_словарь Контейнер (в программировании)

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

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

📦Что автору и редактору стоит делегировать

Есть работа, которую вредно делать самому. Обычно эта та, которая стоит сильно дешевле вашего времени — лучше потратить его на что-нибудь полезное или приятное. Я стабильно делегирую две вещи:

🖋Корректуру. Я человек грамотный, но невнимательный. Чтобы не вычитывать текст по несколько раз повторно, я отдаю его корректору — он все поправит, еще и знаки препинания получше меня расставит. А я за это время поредачу новый текст.

🎧Расшифровку аудио. Я часто пишу тексты на основе интервью, вебинаров и других аудио и видео. Раньше сидела и слушала сама, переносила в текст — это было ужасно. Теперь отдаю на расшифровку. Простые тексты мне стоят 10₽ минута — качество не идеальное, но мне нужно просто что-то, чтобы опереться и не переслушивать аудио целиком. Готовая расшифровка экономит часы времени и тонны нервов.

А что вы в своей работе обычно делегируете? Поделитесь в комментариях, может я тоже что-нибудь начну)

#IT_словарь Облако

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

Пример: Любой сайт в интернете — облако, так как вы удаленно пользуетесь его функциями для своих целей. Например, Гуглдоки — облачный сервис для редактирования документов. А ГуглДиск — для их хранения. Если вы решаете сделать сайт и открываете Тильду — вы тоже пользуетесь облаком, так как Тильда гарантирует сохранность ваших сайтов и предоставляет инструменты для верстки страницы. Даже Вконтакте в какой-то мере облако — ведь позволяет вам хранить файлы, общаться с другими людьми, редактировать изображения и распознавать аудио, ничего не скачивая к себе на компьютер.

🦾Чуток про нейросети, раз уж все про них говорят

У научного фантаста Клиффорда Саймака есть классный рассказ — «Сила воображения». Щас будет спойлер, кто не готов — не читайте пост) Там описано будущее, в котором писатели только собирают образы героев будущего романа — а все остальное им выдает машина, причем безукоризненно и верно с точки зрения всех правил и интересности. И секрет одного самого успешного автора все пытаются выведать весь рассказ. Знаете какой секрет? Оказывается, он пишет сам. Вот это поворот.

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

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

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

🙅‍♂️IT — это не только программисты и сисадмины

Обычно когда говорят «Войти в IT» имеют в виду стать программистом или сисадмином. И под текстами для IT понимают только статьи про применение конкретного языка программирования или построение новой сети в облаке.

Но на самом деле внутри этой машины под общим названием IT сидит еще целая куча людей:
— Дизайнеры, которые прорабатывают внешний вид программ.
— HR, которые нанимают людей и создают удобные условия для работы.
— Менеджеры, которые общаются с клиентами и управляют рабочими процессами.
— Маркетологи, которые все эти разработанные продукты рекламируют и продают. Где-то здесь же находятся IT-авторы и редакторы.
— Переводчики, которые адаптируют программы для зарубежного рынка.
— UX-писатели, которые пишут тексты для интерфейсов.
— Бухгалтеры, которые считают зарплаты, налоги и прочие выплаты.
— Юристы, которые следят за соблюдением законов в часто еще не устоявшемся правовом поле.
— Еще кто-то, кого я случайно забыла, но он точно есть.

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

И если вы решите писать для IT, с этими темами вам вполне возможно предстоит столкнуться. Просто имейте это в виду. И знайте, что если к вам придут с запросом писать про «дизайн приложений» или «управление командами программистов» — без понимания IT вам не обойтись.

👯‍♀️Почему технический автор и IT-автор — не одно и то же

Я заметила, что эти две сущности часто путают. А они вообще про разное, щас поясню, в чем отличие.

🤖Технический автор, технический писатель, техпис
Это человек, который пишет документацию к продуктам. Он рассказывает тем, кто будет пользоваться продуктом, про конкретные функции, возможности, интеграции, особенности кода и функционала. Например, вот документация к API Яндекс Карт — ее написал технический писатель.

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

Технический писатель должен отражать конкретную последовательность действий и понимать четкий принцип работы того, о чем он пишет. При этом художественности, пояснений, сравнений и продаж от его текстов не ждут. Он больше «технический», чем «писатель».

👨‍🎤IT-автор, автор в IT
Это человек, который пишет материалы для IT-компаний: статьи в блог, тексты для лендингов, посты в соцсети, письма в рассылки, публикации в СМИ. Его задача — что-то рассказать клиентам и потенциальным клиентам. Поделиться новой технологией, представить продукт, обучить пользоваться новой фишкой, рассказать о решении какой-то технической задачи.

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

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

Я на этом канале рассказываю как раз о работе IT-авторов и IT-редакторов. Технические писатели — отдельная тема, и я, если честно, про нее почти ничего не знаю)

🧑🏻‍🏫Когда кому-то что-то объясняешь — учишься сам

Для тех, кто не знает — я тут недавно запустила курс для IT-авторов и редакторов про тексты в IT. Вот ссылка, если интересно. Но пост не о том) Сейчас, пока работаю над курсом, словила прикольный инсайт.

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

Но вот наступает момент, когда тебе надо кого-то чему-то научить. Например, ты как редактор нанимаешь нового автора. Или помогаешь другу «научиться зарабатывать на текстах». И в этот момент ты понимаешь, что твои паттерны нельзя просто взять и переложить человеку в голову. Надо как-то объяснить словами.

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

Поэтому всем, кто давно работает и у него все получается — очень советую хоть в каком-то виде попробовать объяснять то, что вы вроде бы и так знаете. Хотя бы статью на Виси написать.

Кстати, за этот инсайт могу поблагодарить свою коллегу и подругу Юлю Сон. Это она меня подбила на запуск курса и потом все организовала и спродюссировала. У нее есть свой телеграм-канал — советую заглянуть, если интересуетесь более организаторской стороной контент-маркетинга: менеджментом, управлением, продажами и всем таким.

#IT_словарь DevOps

Аналогия: Представьте, что вы собираете машину. Вы делаете это сразу целиком и отправляете заказчику. Тот что-то смотрит, тестирует, проверяет — и шлет вам ее целиком назад с правками. Вы снова все правите, исправляете — и шлете. И получаете назад. Это — не DevOps.

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

🐣С какой стороны заходить в IT-редактуру

Когда я начинала писать про IT, я сразу рухнула в омут с головой и начала писать про то, чего не понимала вообще. Какое счастье, что у моего редактора тогда хватило терпения все мне разжевать.

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

👨‍🎓Тексты для курсов. Сейчас вокруг очень много разных курсов, на которых обучают IT-профессиям: Практикум, Скиллбокс и прочее. Часто такие онлайн-школы ведут блоги и набирают туда авторов. Обычно там нужно писать тексты из разряда «Что такое JavaScript», и пока вы их пишете — как раз разберетесь в теме.
🤵‍♂️Тексты для бизнеса. IT-бизнесов сейчас очень много, и все они стремятся продавать свои продукты — ПО или какие-то услуги. Для продажи им нужны тексты — вроде бы про IT, но для тех, кто ничего в этом не понимает. Это часто те же рекламные тексты для лендингов и сайтов, либо какие-то простые статьи в блоги о том, как же выбрать VPN. Этот вариант чуть похуже, чем тексты для курсов, потому что плохо помогает погрузиться в тему. Вы так и остаетесь на уровне «не понимаю глубоко», и углубляться придется самостоятельно. Но зато хотя бы привыкнете к терминам и научитесь брать интервью у айтишников — что тоже очень полезно.

И кстати, обе эти сферы вполне могут стать не стартовой точкой, а постоянной работой. Потому что лезть глубоко в IT — история специфичная и на рынке не самая популярная. А тексты для курсов и бизнеса будут нужны всегда.

🌱Как зайти в IT-редактуру без опыта

Часто в вакансиях на IT-автора и редактора просят показать примеры текстов про IT. Это логично, и я сама так делала, когда искала автора. Тогда на проекте у нас особо не было времени на обучение, поэтому требовались люди, которые хоть примерно погружены в контекст.

Но что делать, если в эту сферу хочется, а текстов пока нет? На самом деле вариант только один — взять и написать текст просто для портфолио. То есть самостоятельно выбрать тему и написать, без заказчика со стороны.

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

Текст даже не обязательно где-то публиковать — можно оставить его в гугл-доке и просто добавить в портфолио ссылку.

Правда учтите, что это все равно не должен быть «просто текст». Подумайте, кто бы у вас мог его заказать, кому он был бы интересен — и отталкивайтесь от этого при написании. То есть вообразите себе ЦА и работайте с ней, как если бы реально писали статью за деньги.

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

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

🍄Темы IT-статей, которые можно написать без эксперта для портфолио

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

💻Программирование
— Язык Golang — зачем учить его в 2023 году
— Как перейти с фронтенда на бэкенд: что изучить, чтобы стать бэкендером
— Какие фреймворки обязательно знать разработчику на (Подставьте любой язык программирования)
— Лучшие IDE для разработчиков в 2023 году
— Возможности Visual Studio Code

🔧Системное администрирование
— Что такое Kubernetes и что о нем важно знать сисадмину
— Как работает Kubernetes в облаке
— Обзор облачных платформ, доступных в России: описание, плюсы и минусы
— Какие решения выбирать в 2023 году: вендорские или опенсорсные
— Что выбрать для проекта: хранилище S3 или базы данных

⛵️Большие данные
— Что такое MLOps и почему в 2023 без этого никуда
— Зачем бизнесу на самом деле нужны большие данные
— Что такое Big Data и какие инструменты нужны, чтобы внедрить эту технологию в свой бизнес
— Какой стек технологий понадобится, чтобы организовать машинное обучение у себя в компании
— Где хранить большие данные: обзор инструментов

👨‍🎓Обучение IT-профессиям
— Войти в IT: какую профессию выбрать, если пока совсем не айтишник
— Топ языков программирования в 2023 году
— Кем стать: фронтендером или бэкендером
— Кем стать: программистом или сисадмином
— Как сисадмину стать DevOps-инженеров

#IT_словарь
Пример: В вакансии разработчика указано, что надо знать JavaScript, HTML, CSS, ReactJS, NextJS и TypeScript. Это и есть стек технологий, с которым работает эта компания.

🤖Можно ли как-то поставить ChatGPT себе на пользу в работе

Пока статью он за нас не напишет (а жаль), но я его уже применяла для нескольких прикольных штук:

→ Написать пример кода. Он отлично справляется с простыми примерами применения какой-то функции или фреймворка, причем еще и классно комментирует этот самый код.
→ Собрать подборку ресурсов для чего-нибудь. Он очень прикольно собирает ссылки на ресурсы, например, для изучения программирования, причем особенно на англоязычные.
→ Быстро объяснить какой-то термин простым языком. Он умеет в прикольные аналогии, мне очень понравилось.
→ Набросать самый каркас статьи. Например, если есть план, он может вам накидать какой-то общей фактуры по каждому пункту — а это потом легко будет дополнить примерами и пояснениями.

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