Борьба за человекочитаемость кода: опыт Хабра

Код Хабра день за днём впитывает в себя время, мысли и чаяния многих людей. Этому коду более 10 лет: он оброс множеством знаний, в том числе и тайных. Места c bus factor = 1 — не эка невидаль, а вполне конкретные люди с ответами на часто задаваемые вопросы.
Меня зовут Антон Каракулов, я тимлид команды бэкенд-разработки Хабра. Хабр стартовал в 2006 году, и за всё время здесь поработало, наверное, команд пять. Мне посчастливилось быть в двух из них, забегал в третью.
Эту статью я написал в рамках проекта Хабра «IT-гид», где разработчики рассказывают про свои направления. Постарался собрать в ней главные практические выводы и интересные грабли, которые нам попадались в процессе превращения старого хабракода в чистый, масштабируемый и понятный для всех — то есть человекочитаемый.
Все события утрированы, а совпадения — беспочвенны.
Технотекст 2022: шорт-листы по номинациям

Авторы отправили 675 заявок на Технотекст, а мы их перебрали и готовы показать номинантов. Короткие списки получились очень даже длинными, что не может не радовать.
Победителей объявим до 14 апреля. Критерии оценки, списки судей и подборки статей по номинациям — в этом посте.
Уровни сложности публикаций на Хабре

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

Привет, Хабр! Январь подходит к концу, а фуршета ещё не было — исправляемся! Тем более, что в понедельник мы ещё не пробовали :) Если есть желание и возможность пообщаться, то все подробности под катом — добро пожаловать.
Модераторы Хабра в лицах: будем знакомы

Я никогда не мечтала быть модератором. Ну то есть, даже мысли не было: хочу или не хочу, в Хабре я занималась совершенно другими вещами. Однако жизнь любит шутить, и 12 июля 2017 года я стала ведущим менеджером по работе с пользователями. Эта должность предполагает кучу функциональных обязанностей, но для пользователей Хабра я именно модератор. Мне казалось, что я неплохо знаю коллег, но изнутри команда оказалась необычной и удивительной, настоящей dream team со своим духом и стилем работы. Мы, модераторы, небольшая команда отдела по борьбе работе с пользователями. Иногда нас спрашивают, а не роботы ли мы. Иногда обижают, иногда сердечно благодарят. С некоторыми пользователями мы дружим, с некоторыми — не очень. Как правило, всё взаимно, всё как у людей.
Мы уже рассказывали о том, как работает модерация — подробно, со смешными примерами и ответами на вопросы. Сегодня мы хотим познакомиться с вами поближе, развеять некоторые мифы, ответить на частые вопросы, рассказать о себе, поделиться некоторыми мыслями, советами, инсайтами и инсайдами. Пойдёмте под кат, я вас со всеми познакомлю!
Хабр Эксперты: IT-менторство на Хабр Карьере

Мы видим, как быстро может меняться IT-рынок: в один месяц все бьются за питонистов, в другой — за мобильных разработчиков, волны увольнений сменяются заморозкой найма и новым набором, новички еще активнее сражаются за первую работу, а эйчары — за топовых сеньоров.
Мы поняли, что в такое время нужно помогать друг другу, и вспомнили, что в IT есть классный инструмент — менторство, который иногда работает даже эффективнее, чем обучение на курсах. Мы протестировали его еще в прошлом году: пригласили несколько специалистов и соединили тех, кому нужен совет, с теми, кто может его дать. Дальше посмотрели на спрос и результат и поняли: да, это нужно.
Так появился сервис Хабр Эксперты — платформа для менти и менторов в IT, которая, мы надеемся, будет помогать учиться и учить всем, кто этого захочет. Рассказываем, что придумали в первой версии.
Маленькая компания на большом Хабре: как выжить среди акул?

Компании на Хабре не любят. Точнее, так: достойная публикация хороша как в корпоративном блоге, так и в частном, а вот так себе статья в блоге компании будет низвержена с особым пристрастием. Это вполне нормальная реакция аудитории на рекламный (хоть и нативный) контент: если делаешь, делай хорошо, мы сюда пришли не рекламные буклеты читать. А с другой стороны, это ещё и возможность прислушаться к отзывам читателей и стать лучше, серьёзнее, актуальнее и глубже. И если вы думаете, что на картинке к статье акула — это большие компании на Хабре, а рыбки — малые, вы ошибаетесь. Рыбки — это все компании, а акула — ироничная, умная и осторожная аудитория Хабра, с которой нужно ладить. Без обмана, навязчивости и непрофессионализма. Трудно, но надо.
Приложение Хабра для Android и iOS

Ну что, я же обещал сюрприз к новому году, хотя и переживал, что мы можем не успеть пройти ревью. Об этом знают даже не все мои коллеги, так как всю работу мы держали в секрете — вы узнаёте в числе первых!
UPD: пост можно прикрепить к 5 хабам — как только выбрал «Разработка под iOS», сразу прошли ревью!
IT-письмо Деду Морозу от тех, кто хорошо себя вёл на работе

Ио-хо-хо, вот и грядёт Новый год, а значит самое время написать письмо Деду Морозу и пожелать себе чего-нибудь хорошего в следующем году. А так как мы профессиональное сообщество, то и желания будут профессиональные. Через год мы отправим вам ваши ответы, чтобы вы могли оценить работу Деда Мороза от 1 до 10, а в декабре 2023 года повторим этот пост и расскажем, какие профессиональные обещания давали себе пользователи Хабра и насколько эти пожелания сбылись.
Новые форматы публикаций

Продолжаем предновогодний калейдоскоп обновлений! Сегодня прям коротенький анонс нововведения, которое, надеюсь, станет хорошим помощником для последующих изменений на сайте.
Итоги 2022 года на Хабре

Короткий итог — 30000 статей, десятки изменений в логике и интерфейсе сайта, 2 больших конкурса, 85 человек в команде, 359 дней нонстопа. Ещё в начале года мы твёрдо знали: надо продолжать делать крупнейший русскоязычный сервис для IT-специалистов и для этого мы задействуем все свои ресурсы. Были дни и даже недели, когда значительная часть команды работала 24/7, были бессонные ночи, были жалобы и благодарности. В некоторых моментах последняя нервная клетка команды пыталась сорваться в бездну, но мы знали — да что там, видели и видим в аналитике, — в нас верят 10 млн тех, кто ежемесячно читает Хабр и больше миллиона зарегистрированных. Эти люди дают и поглощают крутой контент, спорят, дискутируют, грубят и хвалят, устраивают баталии и присылают крутые идеи, сообщают о багах и уязвимостях. Ну что же, перед тем, как идти вперёд, осмелимся вместе оглянуться?
Фуршет декабря

Сегодня в 9:30 выйдет (уже вышла) публикация с итогами года, где упоминаются фуршеты — я подумал и решил, что было бы неплохо там сослаться на новый выпуск, а не на предыдущий. Ну и по понедельникам мы ещё не пробовали, так что решено — декабрьский фуршет объявляется открытым!
Модераторы

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

Привет, Хабр! Заглядывайте под кат, чтобы познакомиться с изменениями на сайте за октябрь/ноябрь.
Причины минусов в карму и история голосов

Теперь голоса можно не только услышать, но ещё и увидеть! Представляем вам 4 новых вкладки в профиле, которые помогут добавить немного порядка.
Раскрываем карты: информационная служба Хабра рассказывает о себе и своей работе

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

Без предварительных ласк, продолжим наш фуршет? :) В этом месяце решил сделать его в будний день, чтобы было время пообщаться сегодня-завтра, а не один день перед выходными.
Правила те же: в комментариях первого уровня одни пользователи пишут, в какой теме они разбираются и готовы поотвечать на вопросы в комментариях второго уровня. Не обязательно что-то из IT — приветствуются любые профи, везде есть интересное!
Фуршет ноября объявляется открытым!
Окей, Хабр, сделай мне интересно

Читать Хабр — важная часть моей работы. Ощущение от статей разное: одни статьи читаешь и жалеешь, что они заканчиваются; от других статей веет нафталиновым сборником вымученных статей аспирантов; третьи утомляют личностью автора; иные раздражают неприкрытой рекламой и т. д. Часто встречаются публикации, которые просто не вызывают никаких эмоций: они просто неинтересные. А ведь почти всегда можно сделать лучше, стоит потратить чуть больше времени, сил и вложить в статью часть души. Кто-то об этом не знает, кто-то ленится, а я печалюсь и пишу ультимативный гайд по тому, как сделать статью интереснее.
Эволюция Технотекста: смотрим фичи этого года и заполняем бэклог на следующий

Докручивая Технотекст 2022, команда Хабра советовалась с участниками прошлых лет. Теперь все номинации завязаны на IT, появилась рассылка для авторов, а технотекстовые посты складируются в отдельном разделе.
Лучшие статьи этого года мы ждём до 10 января: подать заявку можно через красивый лендос, там же расписаны правила участия. А если вы знаете, как улучшить Технотекст, или вам интересно, что творится в коллективном разуме организаторов — добро пожаловать под кат.
Сегодня на обсуждении такой вопрос: каким должен быть идеальный хабровский конкурс? Договоримся так: все идеи, оставленные в комментариях к этому посту до 10 января, я разберу вместе с командой Технотекста. Разумные предложения протащим в Технотекст 2023.