Первое #пятничное

От Слоновой до Мухинской: животные в названиях российских улиц

Продолжаем тему животных анализом топонимов в России. #инфографика от Яндекса по материалам наших карт. Мои любимые фрагменты:

Больше половины названий люди связали с птицами, четверть — с млекопитающими. Ещё почти 10 % пришлись на рыб и 5 % на насекомых. Реже всего на адресных табличках встречаются паукообразные, с ними связаны только два названия — Клещёвская улица в Саратове и улица Клещёвка в селе Хованщино Пензенской области.

Дикие животные упоминаются в названиях гораздо чаще домашних — на них приходится почти 90 % изученных улиц. Самые распространённые из числа домашних — лошадь, коза, корова, гусь и пчела.

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

К вопросу атрибуции арабских цифр

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

О чем говорит название "арабские цифры"? Первая ассоциация - это цифры, которые используют или изобрели арабы. Так? Не совсем.

https://telegra.ph/K-voprosu-atribucii-arabskih-cifr-02-03

#история

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

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

"В конце 1940-х годов мой отец и я открыли фабрику по изготовлению косметического крема. В то время ни одна компания не могла предложить нам пластиковых крышек для баночек с кремом нужного качества, и нам пришлось открыть бизнес по производству пластика. Производства одних пластиковых крышек было мало для загрузки завода по литью пластика, поэтому мы расширили ассортимент за счёт расчёсок, зубных щёток и коробочек для мыла. Бизнес по пластику привёл нас к производству лопастей для электровентиляторов и телефонных коробок, а это, в свою очередь, привело нас к изготовлению электронных приборов и телекоммуникационного оборудования. Также бизнес по производству пластика привёл нас к нефтепереработке, для которой потребовалась компания, осуществляющая танкерные перевозки. Чтобы страховать танкеры, мы в итоге открыли свою страховую компанию. Этот естественный процесс эволюции привёл к образованию корпорации LG в том виде, в котором мы его знаем сегодня".

Как я вкатился (часть 1)

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

В 2015 году я готовился выпускаться из института с дипломом бакалавра лингвистики (обычной, не компьютерной). За плечами уже был опыт организации агентства по переводам, которое не пережило первые санкции в 2014 году, а в процессе было создание онлайн-школы английского, где я был методистом и преподавателем. Skyeng уже гремел, но рынок еще не был поделен окончательно, так что мы с одноклассником прямо-таки влетели в Инстаграм и через 3 месяца работы начали что-то зарабатывать. Сейчас у этой школы, кстати, 560 тысяч подписчиков только в Инстаграме https://www.instagram.com/by_english

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

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

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

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

Я познакомился с его преподавателем (сейчас - моим хорошим знакомым, чьих студентов я периодически слегка менторю перед пристройкой к нам на практику), и отправился к нему проходить подготовительный курс по математике, чтобы попытаться реанимировать мою карьеру в финансах, но довольно быстро понял, что наши занятия могут открыть мне намного более интересный путь.

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

Как я вкатился (часть 2)

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

Практику для себя я тоже определял сам и без какой-то конкретной системы. Начал с С++ и реализовывал базовые структуры данных, в конце вроде бы разработал текстовую RPG, потом занялся версткой и фронтендом на голом HTML и JS. После этого шла Java для серверов и мобилок, потом С#, на котором я сделал музыкальный плеер на WinForms и продвинутую змейку с использованием Godot, ну и все в таком духе. В свободное время я готовился задавать ему новые вопросы, и главным источником знаний и тем для обсуждения для меня был Хабр, который я больше год читал вообще без каких-либо фильтров, просто все подряд, по десятку статей в день.

Через несколько лет оказалось, что именно такой подход лучше всего подготовил меня к работе технического писателя - я достаточно свободно переходил из одной предметной области в другую, и везде уже знал какие-то базовые концепции, которые служили отправными точками для более детального изучения. За время писательской карьеры я работал с фронтендом и визуализацией данных (и сам писал несложный код параллельно на jQuery, Angular, Vue и React), с разными СУБД, брокерами и инструментами для миграции, с облачной инфраструктурой и сетями на уровне IaaS и PaaS (AWS, GCP и Яндекс Облако), ну и сейчас занимаюсь безопасностью в контексте облаков в довольно широком смысле.

Но что было после того, как я уже закончил и институт, и обучение технологиям? Ничего! Больше двух лет я провел за откровенными bullshit jobs с крошечными зарплатами, о которых мне даже почти нечего рассказать. Отсутствие системности в моем образовании (помимо очных занятий, там конечно были GeekBrains и Stepik, позже Udemy) сыграло со мной злую шутку - мне было практически нечего показать на собеседовании кроме того, что я знаю всего понемногу и быстро учусь. У меня было несколько неудачных собеседований в технологические компании, где я на самом деле хотел работать, на позицию инженера технической поддержки, так что пришлось работать там, куда меня взяли. Кстати, на мотивацию для дальнейшего самообучения это тоже оказало негативное влияние, а сами работы были намного больше связаны с маркетингом чем с технологиями.

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

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

Как я вкатился (часть 3)

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

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

В 2024 году, почти через 5 лет после начала писательской карьеры, я все еще довольно слабый стилист и редактор, причем на русском уровень моих навыков только недавно сравнялся с тем, что у меня был на английском. Я не уверен, что я сейчас смогу отсортировать на листе бумаги массив чисел, и я только несколько месяцев назад впервые написал terraform apply.

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

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

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

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

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

3. Чем более сильное окружение в компании с технической точки зрения, тем выше в ней процент людей с техническим образованием. Я изначально готовился к тому, что я буду белой вороной, и просто не тратил времени на размышления в духе "а достоин ли я, а справлюсь ли я, а что подумает литературная общественность будущий коллектив". Но овладеть сравнимым объемом знаний все равно придётся, от этого никуда не деться, особенно если хочется эффективно расти. Но само по себе образование ничего не гарантирует — слабоумие и отвага в сочетании с огнём в глазах для меня намного важнее. Я до сих пор постоянно вижу дискуссии о том, насколько важно специалисту образование, но уже давно в них не участвую. У меня самого скорее диплом чем образование, и мне неинтересно что-то доказывать.

Вот теперь точно всё.

Начало тут.

Очень люблю всякие мнемонические приёмы для запоминания вещей, которые нужны пару раз в год или реже, но которые стыдно не знать. У меня есть один (любимый) для уровней модели OSI:

[Физический] Фазан
[Канальный] Купил
[Сетевой] Сосиску
[Транспортный] Теперь
[Сеансовый] Сосет
[Представления и прикладной] ПиПиску

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

[Application] All
[Presentation] People
[Session] Should
[Transport] Try
[Network] New
[Data Link] Dr
[Physical] Pepper

Штош, здравствуйте

Недавно число подписчиков канала выросло более чем в два раза благодаря тому, что Катя @ushkatia добавила мой канал в свою публичную папку. Вряд ли кто-то не знает, но на всякий случай — Катя возглавляет команду технической документации в Ozon, ну а ее канал я сам читаю достаточно давно. Теперь мне даже немного неловко, ведь мой канал на самом деле не о документации.

Но я в любом случае очень рад всем новым подписчикам, поэтому расскажу немного о себе. Я Саша, и команда документации Яндекс Облака терпит меня в своих рядах. А еще я ботоголик В писательском сообществе вы можете знать меня как автора бота Forwarder в Желтом чате, антиспам-бота там же, и как одного из создателей Белого чата. Если же вы состоите в Черном чате, то мой бот мог приветствовать вас при вступлении в этот чат.

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

1. Рассказ в двух частях с большим комментарием от подписчика и коллеги о том, почему не стоит при мне травить байку про американцев, потративших миллионы на изобретение ручки, которая пишет в космосе, когда смекалистые советские космонавты использовали карандаш https://t.me/teh_lytdybr/50

2. Маленький пост про идеальную документацию для азбуки Морзе https://t.me/teh_lytdybr/59

3. Экскурс в историю с разбором того, почему привычные нам цифры — не совсем арабские, а арабы нечасто используют собственно арабские цифры https://t.me/teh_lytdybr/64

Вне списка — очень длинная рефлексия на тему моего собственного вкатывания в айти во второй половине прошлого десятилетия https://t.me/teh_lytdybr/67

Очень впечатляющая визуализация Солнечной системы с пропорциональным отображением расстояния между планетами, и говорящим названием «Of the Moon were only 1 pixel». Хорошее напоминание о том, что космос состоит в основном из пустоты.

Можно переключаться между планетами или поставить анимацию для движения со скоростью, условно соответствующей скорости света, а расстояние мерить в световых минутах, синих китах или великих китайских стенах. До Плутона можно добраться от Солнца примерно за 328 световых минут (около 6 млрд км), и это скука смертная.

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

https://joshworth.com/dev/pixelspace/pixelspace_solarsystem.html

Стал вторым автором квизов на канале @quizzes4fun.

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

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

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

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

О правилах и исключениях

(Переписал и расширил старый пост)

«Я никогда не делаю исключений из правил. Исключения опровергают правило.» — Шерлок Холмс.

Выражение «исключения лишь подтверждают правило» всегда вызывало у меня недоумение. Почему оно так часто используется и воспринимается как самоочевидное? Что оно на самом деле означает, и означает ли что-нибудь?

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

Другими словами, когда есть исключение из правила, мы знаем, что должно существовать правило, из которого оно является исключением. Наличие исключения, применимого к конкретному случаю, устанавливает (доказывает), что существует общее правило. Если перефразировать, то самое обоснованное значение — доказательство существования какого-то правила.

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

Изначально, это выражение звучало как «exceptio probat Regam in casibus non exceptis», аргумента, приписываемого Цицерону, появившемуся в его речи на суде в защиту Луция Корнелиуса Бальба. Он стал первым консулом римской республики, родившимся за пределами ее территории, и его обвиняли в незаконном получении гражданства.

В ряде международных договоров о взаимном признании между Римом и соседними государствами был пункт, который чётко запрещал двойное гражданство. Это означало, что жители этих стран не могли стать гражданами Рима, не отказавшись от своего прежнего гражданства. У Бальба было двойное гражданство, и это стало формальным основанием для обвинения. Цицерон утверждал, что если в некоторых договорах есть такое ограничение, то в тех, где его нет, действует противоположное правило, позволяющее двойное гражданство.

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

Беглый анализ показал, что этот вариант в русский язык попал не напрямую через латынь (probat — подтверждать), а через английский (probe — проверять). Правда, в другом источнике я нашел указание на то, что вместо exception probe мог использоваться архаизм exception preuves (то же что и tests), который впоследствии могли написать как exception proves, что в итоге все равно приводит к тому же варианту исключения, подтверждающего правило.

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

Это был первый пост в рубрике #язык.

Дни художника

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

Праздник мастеров холста и кисти был учрежден в 2007 году по инициативе Международной ассоциации «Искусство народов мира». Она была основана в 1988 году художником и меценатом Николаем Корниловым, который подарил несколько сотен картин из своего собрания городам России. Так, он передал около 700 полотен городу Петушки во Владимирской области, что позволило открыть там галерею современного искусства «НИКОР».

Это я к тому, что у всех сегодня есть повод поздравить своих художников, как у меня есть поводу поздравить Еву, @ilves_magic.

А связанная с этим новость — послезавтра, 27 октября, я проведу финисаж её персональной выставки, как до этого проводил вернисаж. Буду в галерее AvArt с 15:30 до 19:00 рассказывать про искусство то, что не дорассказал месяц назад. Вход свободный, шампанское бесплатное.

А вот что рассказывает про это сам автор, можно узнать на странице аудио-экскурсии, посвященной этой выставке https://evailves.ninja/audio-video-tours/avart-2024/

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

Сравнение генераторов статических сайтов

Прекратил прокрастинировать и сделал себе простой сайт, на котором разместил статью, написанную для @quizzes4fun, со сравнительным анализом Docusaurus, MkDocs, Diplodoc, Sphinx, Hugo и Jekyll на основе своего опыта.

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

С другой стороны, я помню, сколько разных инструментов мне пришлось перепробовать, чтобы начать хотя бы на базовом уровне разбираться в этой области. Я всем традиционно рекомендую выбирать генератор на https://jamstack.org, фильтруя по языкам и ориентируясь на количество звезд на GitHub, но мне недавно напомнили, что это все равно может быть выбор из десятков разных вариантов, со многими «за» и «против» для каждого из них.

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

#техписовое

О реквестах

С тех пор как я начал работать с GitHub, меня интересовал термин Pull request. Я никак не мог понять, почему это именно pull, а не push, мне казалось очевидным, что это просьба о внесении изменений, ведь в результате одобрения владельца репозитория именно я обновлю (добавлю, удалю) файлы, да и push в удаленный репозиторий выполняю тоже я.

В ответ я почти всегда видел непонимающие взгляды и слышал абсолютно не удовлетворяющие меня объяснения в духе «ну ты же не можешь сам вмержить, у тебя прав нет». В этом есть логика и это фактически так, но зачем было создавать такую двусмысленность, если GitHub был новатором своего времени и можно было выбрать любой термин? Русский вариант в локализованном интерфейсе Visual Studio кстати звучал как «запрос на вытягивание», что я лично считаю вершиной локализаторского мастерства. Зато таких проблем никогда не было с GitLab, там всегда был понятный Merge request, и даже русифицированный вариант «Запрос на слияние» был как минимум не ужасным.

Прошли годы, я принял наличие этого термина как данность, и вдруг мне попался тред в X (ex-Twitter), который начинался с сообщения, которое приведено на скриншоте. В тред пришел отвечать Scott Chacon, один из сооснователей GitHub, объяснивший несколько ключевых вещей:

1. GitHub адаптировал название неизвестной мне команды в Git из тех времен, когда изменения буквально отправлялись по почте и это был именно request принятия изменений, локальной сборки этих изменений и последующего затягивания в ветку от имени человека, у которого есть права на такие действия.
2. Они были первыми, и им нужно было на что-то опираться из понятных сообществу терминов.
3. GitLab придумал свою терминологию уже после того, как GitHub стал популярен.
4. Действительно не происходит push в главную ветку проекта, в который предлагаются изменения.

Ниже выдержка из его твитов (но лучше почитать полный тред по ссылке выше):

There is a git command called “git request-pull” that would format an email that you could send to a mailing list saying “instead of me sending an email patch series, here is a public endpoint you can pull from to test my series”. We turned “request a pull” into a “Pull Request”
———
They were just emails saying “x wants you to pull from them” and they weren’t even formatted as helpfully as the “request-pull” ones. No diffstat, nothing.
———
People are like “Merge Request is better”, but thats only because GitLab emerged after we invented a way to merge on the server. Before that you had to pull locally, merge there, then push your integration up. Merge Request would have made no sense when we created the concept.

Как нейросети выдавили ABBYY с рынка перевода текстов

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

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

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

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

Читайте: https://sysblok.ru/blog/gorkij-urok-abbyy-kak-lingvisty-proigrali-poslednjuju-bitvu-za-nlp/

#чтиво

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

Моё ретро за год:

1. Написал статью про сравнение SSG, которая действительно понравилась людям. Она про мой субъективный опыт, но, судя по реакции, людям не хватало такого базового сравнения. Свой опыт вкатывания в айти я кстати тоже описал, аж в трёх частях.

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

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

3. Как младший барсук дальнего леса из администраторов в крупнейшем сообществе писателей, я случайно запилил аж трёх ботов:
* В начале прошлого года — бота для управления знаниями за счет автоматической пересылки в топики Белого чата;
* Через несколько месяцев - антиспам на регулярках, с одним из самых развестых наборов регулярок в рунете. В итоге получилось коло 5 000 забаненных спамеров только в автоматическом режиме;
* Бота с капчей, анонс которого, кажется, стал самым залайканным сообщением в Жёлтом чате.

4. Зарегистрировался на TechWriter Days 2, где мы с коллегой зачитаем мощнейший хип-хоп (ладно, на деле мне пришлось отказаться от такой подачи информации) про линтер на основе YandexGPT в конце марта 2025 года. Ставьте лайки, приходите послушать, буду рад развиртуализироваться.

Кажется, год получился успешный. На этом всё, спасибо что читаете, до встречи в новом году!

Обзор трендов ИИ в документации (не мой)

Вечером первой рабочей пятницы приятно почитать что-нибудь расслабляющее, например мнение одного из старших технических писателей Google (судя по резюме — лид документации Google Fuchsia) на то, что принёс в эту сферу 2024 год. Обзор не то чтобы был слишком информативный, но это в любом случае лучше, чем ничего. Отдельный плюс автору за анализ своих предсказаний, данных в конце 2023 года, значительная часть из которых не сбылись.

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

2024 Machine Learning Review (For Technical Writers)

#чтиво

Международный день наставничества

Сегодня, 17 января, когда по всему миру отмечают свой праздник менторы, я хочу сделать несколько вещей:

1. Поблагодарить всех тех, кто доверился мне и пришел на сессию, чтобы поговорить о своей карьере;

2. Поблагодарить @ArinaBallerina, которая вовлекла меня в это дело, без предупреждения направив ко мне первого менти из числа технических писателей;

3. Пропиарить свой профиль на GetMentor — лучшей площадке для менторов в рунете, обладающей также потрясающим внутренним сообществом (да, это рекомендация для будущих менторов).

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

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

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

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

Это я всё веду к тому, что менторство — отличная штука, как для менти, который может получить выдержки из многолетнего опыта за пару часов, так и для ментора, который может получше узнать и себя, и других. Ходите к менторам, растите и становитесь менторами сами, это захватывает!

Что я читаю про документацию на английском

Катя @ushkatia поделилась списком источников актуальных знаний на английском языке. 6 хороших ресурсов, из которых я отслеживаю обновления на сайте конференции Write the Docs через ежемесячную рассылку.

Её пост: https://t.me/ringova/672

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

NB: Единственным сайтом по профессиональной тематике на русском языке, который я отслеживаю, остаётся Хабр, у которого сверхгибкая настройка условий для попадания постов в ленту, которая потом еще и отправляется через RSS. Всё остальное у меня в Телеграме.

Итак, список тех, кого я читаю регулярно:

1. idratherbewriting.com

Думаю, что сайт Тома Джонсона должен быть первым в этом списке. Многие так или иначе сталкивались с его курсом по документации API, ну или с его локализованным вариантом, но на самом деле автор практически каждый месяц поставляет что-то интересное, в том числе принимая участие в публичных дискуссиях в англоязычном сообществе. Его сайт открывается в России не у всех провайдеров, так что можно готовиться использовать VPN.

2. thisisimportant.net

Сайт писательницы Sarah Moir (Splunk, Snowflake, etc). Интересен практически каждый пост, но мой главный хит (породивший дискуссию с Томом Джонсоном) — Docs as code is a broken promise. Читать и перечитывать тем, кто думает, что точно знает реалии работы с docs as code с организационной стороны.

3. passo.uno

Fabrizio Ferri Benedetti первый писатель из англосферы, живущий за пределами США — в Барселоне. У него хорошие навыки программирования и он занимается этим в свободное время, что отражается на его постах. Я бы сказал, что в равной степени они посвящены docs as code, программированию, UX и карьере в общем смысле. Любимый пост выбрать сложно, но для разнообразия пусть будет Technical writing is not a dead-end job, it's a landing pad

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

1. ffeathers.wordpress.com

Сайт Sarah Maddox, проработавшей десять лет в Гугле и запускавшей программу Season of Docs. Последний пост был про то, как она на время бросает айти и уехала кататься по Австралии, но я всё ещё жду новых постов, потому что раньше они были превосходными: Financial impacts of good or bad communication

2. docsbydesign.com

Bob Watson писал документацию задолго до моего появления на свет. Я подписался на его блог после короткого, зато прямо-таки программного поста: Proving and defending the value of technical writing, again

3. technicalwriting.dev

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

А что у вас есть из интересных источников?

#чтиво