Лена из машины
248 subscribers
51 photos
19 links
Советы, лайфхаки и прочие штуки про редактуру IT-текстов.

Делится @LShpringer — IT-редактор и автор в VK Cloud, Яндекс.Практикуме и других. Консультирую в ЛС про тексты в IT.

Мой курс по редактуре текстов в IT → https://tinyurl.com/28smysfs
Download Telegram
⚔️Канал не умер, просто лето — время хобби⚔️

Поэтому хочу с вами немного поговорить на отвлеченную от работы тему — про увлечения.

Я вот занимаюсь ролевыми играми, но не теми, про которые вы могли подумать. Мы с друзьями несколько раз за лето наряжаемся то в средневековое, то в научно-фантастическое, то еще в какое-то, выезжаем в лес и разыгрываем там разные сюжеты, придуманные мастерами игр. Вот вам фоточек с нескольких проектов, где я побывала.

Расскажите в комментариях, кто чем занимается помимо работы? Интересно узнать, кто как проводит свободное время или для чего зарабатывает такие огромные денжищи в копирайтинге и IT?
🔥23👍4
📁Можно ли писать на Хабр не про IT📁

На самом деле можно, но надо очень четко понять, нужно ли. Есть три темы, которые там хорошо заходят, хотя часто не связаны с IT напрямую.

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

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

🎓Научпоп. На Хабре очень любят классные качественные научно-популярные статьи и новости на любые темы: от переработки мусора до открытия космических объектов. Тут важно, чтобы человек понимал то, о чем пишет, и рассказывал это действительно интересно и также понятно широкой аудитории. Как и в любом научпопе.

💡Зачем вообще писать на Хабр не про IT. Если айтишники — часть вашей аудитории. Например, вы помогаете людям с переездами. Или разрабатываете приложение для тайм-менеджмента. Или продаете курсы для повышения общей эрудиции. Во всех этих и подобных случаях Хабр можно использовать как дополнительную площадку с огромной и вовлеченной аудиторией — особенно если прошлые площадки уже кажется себя исчерпали.
Please open Telegram to view this post
VIEW IN TELEGRAM
👍12🔥4
#Объясняю_ITмемы

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

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

Юмор здесь в том, что во многих языках программирования для разграничения функций между собой используют как раз вот такие фигурные скобки: открывающие и закрывающие. Часто эти скобки вложены друг в друга — внутри функции есть еще функция, и так очень много раз. В итоге ты скобки открываешь, открываешь, открываешь — а закрывать надо только в конце. Из-за чего очень легко одну закрывающую скобку пропустить — и тогда окажется, что какую-то функцию ты не закрыл, из-за чего ломается вообще все. И если такая ошибка попадет на прод, пользователям это не понравится =)

Ну и скобочки эти похожи на птичек, поэтому собственно это косяк и он летит. Лучше бы не летел)
😁24🔥9👍3
❔В чем заключается работа редактора❔

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

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

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

А что вы думаете об этом вопросе? В чем для вас суть работы редактора?
Please open Telegram to view this post
VIEW IN TELEGRAM
👍20🔥6🤔5
#Объясняю_ITмемы

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

Как правило в командах есть руководитель, который контролирует весь процесс разработки. Часто это тимлид, то есть team leader, лидер команды.

Может показаться, что тимлид сам не ходит, постоянно что-то контролирует и по сути только мешает программистам работать. Но на самом деле без него получится примерно так, как на этом меме.
👍11🔥7😁7
😏Почему вам в статьях нужны мемы

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

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

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

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

Сразу приведу пример. В языке JavaScript есть прикол — когда мы задаем переменную, мы не говорим, строка это или число. И по умолчанию язык может посчитать, что переменные n=1 и m=2 — это строки, а не числа. В итоге если вы сделаете операцию m+n, вы получите не ожидаемую «3», а «12» — потому что JavaScript не сложил числа, а сложил строки, расположив их рядом.

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

А что вы думаете про мемы в статьях? И используете сами?
Please open Telegram to view this post
VIEW IN TELEGRAM
😁9👍8
🖥Как я пишу примеры кода для статей🖥

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

Решить проблему с кодом мне помог ChatGPT. Он прекрасно справляется с примерами кода разного уровня: может сравнить одну и ту же операцию в разных языках, продемонстрировать наглядно какую-нибудь библиотеку и даже написать с нуля несложную программу, например, игру.

В прикрепленных картинках — примеры кода, которые он мне выдал по разным запросам. Я использую российский сервис Chad, который дает доступ к ChatGPT без всяких заморочек.

Главное здесь помнить, что ChatGPT пока не идеален, и эксперт все равно должен будет проверить, что он там понаписал. Но проверить проще, чем написать — особенно учитывая, что ChatGPT прекрасно комментирует все, что накодил.
Please open Telegram to view this post
VIEW IN TELEGRAM
Please open Telegram to view this post
VIEW IN TELEGRAM
👍8🔥8
#Объясняю_ITмемы

Есть языки программирования: Python, PHP, Java, C#, C++ и всякие еще другие вроде Go. На них программисты пишут программы, которые умеют что-то делать — например, считать или анализировать данные.

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

Поэтому говорить, что HTML язык программирования — нельзя. Но так иногда говорят, потому что HTML «маскируется» и «тоже IT» — прямо как этот котик, притворяющийся хлебом.
😁14👍9🔥3
🐾Почему аналогии плохи для споров, но хороши для текстов

Аналогия — это когда вы поясняете что-то сложное или неоднозначное через что-то более простое и понятное, но из другой области. Сравнивая языки программирования и HTML с хлебом и котиком например (это как в посте выше). В отличие от примера, тут мы не показываем применение сложного на практике, а берем объяснение из другой области, просто чтобы что-то сложное стало понятнее.

🐾Аналогии иногда любят использовать в спорах, приводя их как аргумент. Но это прям так себе идея, потому что внешнее сходство не означает сходства внутреннего. Слышали когда-нибудь фразу: «Хорош тот ключ, что открывает много замков — и плох тот замок, что открывается многими ключами»? Ее иногда используют для оправдания женской моногамии и мужской полигамии, если что =) Это как раз аналогия, вот только люди не ключи и не замки, и никаким вообще логическим доказательством чего-либо это не является. Поэтому использовать аналогию, чтобы доказать правдивость чего-то через якобы «подобное» — это ошибка.

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

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

🐾А вы часто используете аналогии в своих статьях? И что думаете об аргументацию через аналогии? Поделитесь в комментариях!
Please open Telegram to view this post
VIEW IN TELEGRAM
👍11🔥5🤔2
🎭«Пассивная агрессия» в статьях🎭

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

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

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

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

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

А вы бы кстати как назвали такое «поведение» в статьях? И как часто с ним сталкивались? И какие оно у вас ощущения вызывает?
🔥13👍8😱2🤔1
❔Как вы обозначаете свою профессию?❔

Каждый раз, когда меня спрашивают, кем я работаю — я теряюсь.

Много лет назад я смело отвечала, что «копирайтером». Но это было во времена, когда я статью «Как варить гречку» начинала со слов «История гречки насчитывает тысячелетия...». Даже тогда это, кстати, не было копирайтингом, но ни в каком значении это слово мне теперь не подходит.

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

В последнее время я использую сочетание «коммерческий редактор», но и тут все стало не так однозначно. С недавних пор я помогаю редактировать образовательные продукты Практикума — а это вообще не коммерческие тексты. Да и информационные лонгриды куда-нибудь на Хабр тоже не особо коммерческие — это не рекламные статьи и не лендинги. Тоже немного не то.

Остановилась пока коммерческом редакторе, но чувствую, что что-то не то. Так что расскажите, а как себя называете вы, опираясь на специфику вашей деятельности? Особенно вне диджитал и редакторской тусовки?
Please open Telegram to view this post
VIEW IN TELEGRAM
👍13🤔4
🖇Не нужно постоянно делать списки

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

Я в редактуре часто сталкиваюсь с ситуациями, которые выглядят примерно вот так:

«Далее необходимо разделить приложение на две части:
- клиентский код,
- серверный код.»


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

На мой взгляд, если в списке две–три сущности, и они однотипные и простые — их нужно просто оставить в предложении, вот так:

«Далее необходимо разделить приложение на две части: клиентский и серверный код».

Так гораздо легче и чище.

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

Схема может показаться слишком сложной, но на то есть своя причина. В этом поде у нас три контейнера:

1. В первом работает Vector. Его основная цель — сбор логов.
2. Второй контейнер — Reloader. У пользователей нашей платформы есть возможность описывать собственные пайплайны сборки логов. Специальный оператор берёт заданные пользователями данные и составляет configmap для Vector. Задача Reloader — проверить, что config правильный, и, если так, перезагрузить Vector.
3. Третий контейнер — Kube RBAC proxy. Он важен, поскольку Vector выводит различные метрики о собираемых логах. Эта информация может быть конфиденциальной, поэтому важно защитить её надлежащей авторизацией.
👍25🤔3👎1
🗒Заключения к статьям

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

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

Иногда их пишут в таком стиле:

В этой статье вы узнали:
1. Что такое сепульки.
2. Как производить сепуление.
3. Кто такой сепулятор.

Я считаю, что так делать нельзя, это никак не помогает читателю ничего подытожить. Вместо этого лучше делать так:

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


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

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

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

Пишите в комментариях, как вы стараетесь писать заключения, и стараетесь ли вообще. И ставьте реакцию молнии, если хотите поговорить про вообще нужность и ненужность заключения — напишу про это что-нибудь)
Please open Telegram to view this post
VIEW IN TELEGRAM
⚡18🔥7👍3
❤️Моя стратегия жизни в мире сбоев и блокировок❤️

Интернет вчера опять сбойнул и ВК был доступен, а Гуглдоки например нет. Что угодно в любой момент может надолго или навсегда отключиться — ничего с этим не поделаешь. Чтобы не пострадать от этого, я делаю следующее:

1. Раз в неделю делаю бэкап Гуглдиска — вручную качаю самые важные документы себе на компьютер. Наверное есть инструменты автоматизации, но мне проще вручную. Иногда если написала что-то очень важное — бэкаплю сразу.
2. Слежу за новостями о возможных блокировках. Если где-то что-то говорят — предпочитаю или вообще сразу перейти на альтернативу, или хотя бы поискать. Так я ушла из Трелло для ведения личных дел еще до того, как с ним возникли проблемы.
3. Не игнорирую нейросети, хотя многие доступны как-то мутно — пользуюсь российскими или способами обхода и доступа к зарубежным. Нейросети пока не супер-важны, но скоро станут базовым навыком, как компьютерная грамотность — не хочу его упустить из-за блокировок. (Ставьте реакцию глаз, если хотите, чтобы мы поговорили про то, как пользоваться нейросетями в редакторской работе в России без страшных танцев с бубном).
4. Не удаляю текстовые и табличные редакторы с компьютера, хотя почти ими не пользуюсь. Во время сбоя вот пригодились, чтобы срочно распечатать документ.
5. Все критически важное держу у себя на диске и в российских облаках типа Яндекса, но без фанатизма — есть риск потерять, но наверное как-то это переживу.

В итоге по мне все эти принципы помогают не нервничать, ничего не терять и нормально работать, даже когда что-то куда-то сыплется. Поделитесь в комментариях, что делаете вы.
Please open Telegram to view this post
VIEW IN TELEGRAM
👀25👍2
#Объясняю_ITмемы

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

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

Это как если бы вам как редактору в качестве тестового всегда давали похожий текст и задание «Придумайте к тексту 5 заголовков».

Так что котик грустит в бесконечном цикле одинаковости.
😁5👍1