Ребят, последние дни я вспомнил, что я – автор (и мейнтейнер) крупного фреймворка.

FastStream, если кто не в курсе🌚

(А то все про продуктивность, да разработку говорили)

Для меня это уже норма жизни, но мб кому-то интересен именно этот аспект?

Что бы вы хотели спросить у меня:

- как продвигать проект? какие каналы работают, какие - нет?
- как вырабатывать идеи?
- как много времени у меня на это уходит?
- что я с этого имею?
- какие типовые задачи я решаю в Open Source'е в течении дня? Недели? Квартала?
- как вообще выглядит планирование в OSS?
- как помогает сообщество?

В общем, накидайте вопросов в комменты – обсудим. А что-то мб выльется и в отдельный пост / статью / доклад.

У меня есть идея подготовить доклад на следующий сезон "Люди и Open Source" – про поиск пользователей, поиск контрибуторов, их (и свою) мотивацию, виды задач в OSS и всякое такое.

Но мб идея тухлая и ваши вопросики направят меня в нужную сторону.

OpenSource не помогает найти работу!

А потом тебе пишут на почту с предложением работы в зарубежном стартапе на очень вкусные цифры...

Оказывается, появилась целая платформа для HR, где мониторится топ-перформеров на гите🤯

https://algora.io/profile/Lancetnik

UPD: оказывается, там есть еще и Issue-баунти. Компании назначают вознаграждение за PR'ы. Как вам 3.500$ за MCP?

В общем, бежим коммитить!

Btw, на неделе закину историю другого человека, кто нашел работу благодаря Open Source🌚 И нет, он не мейнтейнер / топ-перформер или что-то вроде

Документация для нейронок

Вот в этом посте я уже рассуждал о том, что современные инструменты должны быть адаптированы для использования нейросетями. А сегодня я узнал, что в 2024 году вышел новый формат документации сайта `llms.txt`. Его предложил Jeremy Howard (основатель Fast.ai и бывший CEO Kaggle)

Это такой аналог sitemap.xml, но для LLMs. Он позволит нейросетевым поисковикам эффективнее взаимодействовать с вашими сайтами, а также будет посадочной страницей для MCP типа Context7.

Для меня пока что звучит сомнительно, но многие крупные игроки уже поддержали стандарт:
- Cloudflare - https://developers.cloudflare.com/llms.txt
- Anthropic - https://docs.anthropic.com/llms.txt
- Docker - https://docs.docker.com/llms.txt
- Netlify - https://docs.netlify.com/llms.txt
- Stripe - https://docs.stripe.com/llms.txt
- Pydantic - https://docs.pydantic.dev/latest/llms.txt
- многие другие

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

Поэтому я хочу добавить llms.txt для документации FastStream. А вы можете помочь мне и законтрибутить это (все детали в Issue)

– https://github.com/ag2ai/faststream/issues/2417

Кстати, в репозитории FastStream уже лежит набор правил для Cursor. Он пока сыроват, но вы также можете в него коммитить!

#AI #FastStream

Прошла ровно неделя с моего начала работы над AG2, а я уже придумал, куда там затащить FastStream🌚

Похоже, нас ждет распределенный мультигентный меш на FastStream + NATS🤯

Попробуем накидать хайповые названия в комменты?

Зачем идти в Open Source джуну?

Я часто сталкиваюсь с убеждением, что OpenSource'ом занимаются какие-то странные разработчики из высших материй, кому уже слишком просто "перекладывать JSON'ы". И это так. Но только отчасти.

На самом деле OpenSource – очень разный. Люди могут заниматься в рамках открытых проектов совсем разными задачами. И для большей части задач нужен совсем минимальный уровень экспертизы.

Хочу поделиться с вами вдохновляющей историей разработчика, который сейчас работает в команде FastAPI (вашего любимого / ненавистного фреймворка). А попал он туда очень просто – отвечал на вопросы по фреймворку на всех возможных площадках!

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

Я сменил сферу деятельности (из других областей ИТ), а без релевантного опыта сейчас найти работу очень сложно. Я решил идти этим путём вместо того чтобы откликаться на вакансии. И сработало) Всего 1.5 года до первой работы и ещё 8 месяцев до хорошей работы!

Времени тратил в разные периоды по-разному. Пока не было работы - часа по 4 в день, в остальное время учил что-нибудь. Когда начал работать - часов по 5-10 в неделю.

Я в основном отвечал на Stackoverflow, позже начал и на гитхаб. Брал вопрос который был интересен и начинал разбираться. Иногда сдавался. Смотрел как другие отвечают. Очень помогло пройтись по открытым пулл-реквестам с меткой BUG, часто ответом было просто 'да, это известный баг'

Даже если вы джун (или особенно), вы можете сделать очень много полезного для себя и мира в OpenSource. Работа над открытыми проектами позволит вам:

– получить опыт работы в команде, который вы не получите на своих петах
– познакомиться с "промышленным" пайплайном разработки. Что такое линтеры, тесты, CI, процессы ревью, релизный цикл, обратная совместимость и тд
– прокачать свое резюме. Участие в важных экосистемных проектах точно выделит ваше резюме из сотен других
– регулярно сталкиваться с проблемами реальных пользователей с продакшена (и помогать их решать). Умный ведь учится на чужих ошибках?
– получить публичное портфолио. По нему прекрасно видно, как вы коммуницируете, решаете проблемы, пишете код. Некоторые лиды не ленятся на это смотреть, это гораздо полезнее тестового задания
– получить полезные связи

Последний пункт, к слову, самый важный. Это не очевидная мысль, но OpenSource – это такая же работа. А лучший способ найти работу – если тебя подтянет бывший коллега. Он уже знает, на что вы способны, как решаете проблемы, какой код пишете. Он с вами работал. Даже если работал в рамках OpenSource. Я знаю примеры, когда люди находили работу таким способом.

В общем

OpenSource – это способ зайти в IT сбоку

Не самый быстрый, не самый надежный, не самый масштабируемый. Но очень интересный😅 Так зачем биться в те же ворота, что и остальные?)

Эффективность > Продуктивность. Как перестать бежать и начать двигаться к цели

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

Когда-то я запустил серию постов по Дорофееву, где говорил о продуктивности. Но самая главная тема осталась нераскрытой – как НЕ БЫТЬ НЕЭФФЕКТИВНЫМ.

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

🏃‍♂️ Продуктивность — это про "много сделал". Это чистые действия. Можно закрыть 20 мелких багов, ответить на 50 сообщений в Slack и остаться на том же месте. Голая продуктивность — это спринт на беговой дорожке, который выжимает все соки.

🎯 Эффективность — это про "насколько я приблизился к цели". Это ЦЕЛЬ + ДЕЙСТВИЯ. Можно закрыть всего одну, но самую важную задачу, и сделать гигантский шаг вперед.

Поэтому у эффективности всего 2 простых рецепта:

1. Понять, куда ты движешься (Какая у меня цель на этот месяц/квартал?)
2. Отсечь всё, что не двигает тебя в эту сторону

Предлагаю на этой неделе провести небольшой аудит своих действий. Не глобально, а в моменте:

- Пилишь пет-проект? – Какую цель он преследует: выучить технологию, попасть в портфолио или это просто прокрастинация от основной работы?
- Изучаешь новый модный фреймворк? – Как это поможет тебе в текущих или будущих задачах?
- Смотришь 5-ю серию сериала за вечер? – Это осознанный отдых, который тебя заряжает, или способ убежать от мыслей о важном?

Я не говорю, что так делать не нужно. Но немного осознанности никогда не помешает...

Завтра закину полный список рецептов, которые помогли мне выбраться из выгорания и начать перформить как в лучшие годы😅

#Дорофеев #эффективность #продуктивность

Тема с "документацией для нейронок" развивается... Встречайте – AGENTS.md🤯

Это как README, только для агентов. Ну вы поняли

Примеры:
- Airflow
- Codex
- Temporal
- Pluto

Интересно, что будет следующим? mkdocs-agents, который дублирует навигацию в llms.txt?

Моя система эффективности: как я выбрался из выгорания и начал перформить

Как и обещал вчера, делюсь своим списком "рецептов", которые помогают мне быть не просто продуктивным, а именно эффективным. Это не волшебная таблетка, а система, которую я выстраивал через пробы и ошибки. И восстанавливал, когда она рухнула😢

Вся система держится на одном главном принципе, который я до сих пор в себе воспитываю:

🎯 Принцип №1: Искать 80% результата за 20% усилий.
Мой главный враг — перфекционизм. Я могу потратить кучу времени, чтобы довести задачу до 100% идеала. Но правда в том, что эти последние 20% улучшений часто не нужны никому, кроме меня. Научиться говорить себе "стоп, этого уже достаточно" — главный скилл для сохранения энергии.

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

Генерация "мыслетоплива"
Нельзя быть эффективным на пустом баке. Поэтому сначала — заправка.

- Больше спорта. Особенно игрового (у меня это теннис), где мозг полностью переключается с работы на движение. Плюс немного ЛФК, чтобы спина не отвалилась.
- Холодный душ каждое утро. Звучит как пытка, но это лучший способ быстро "перезагрузить" систему и получить заряд бодрости на несколько часов.

Защита "мыслетоплива"
Мало генерировать энергию, нужно перестать сливать ее впустую. Это мой самый важный блок.

- "Zero Inbox" как стиль жизни. Отписался от всех рассылок, настроил фильтры. Теперь почта всегда пустая, и я трачу на нее 2 минуты в день, а не живу с вечным чувством "там что-то важное".
- Цифровая гигиена в чатах. Вышел из десятков чатов, оставил самый минимум. Не вступаю в бессмысленные дискуссии — это прямое применение принципа 80/20 к общению.
- Информационная диета. Резко сократил количество мусорного контента: фоновая музыка, "видосики" на YouTube, бесконечные сериалы. Мозг тоже устает от переваривания информации.
- Правило бойскаута для рабочего (и жилого) места. Бардак высасывает энергию. Вместо того чтобы раз в месяц делать "героическую" уборку, я просто убираю за собой по мелочи сразу. "Оставь место чище, чем оно было до тебя".

Осознанный отдых
Эффективность — это не про работу 24/7, а про качественные спринты и качественный отдых.

- ОТДЫХ ВНЕСЕН В ПЛАН. Это ключевое. Я прямо в таск-менеджер вписываю: "12:00 - 12:45 - Прогулка" или "Почитать книгу 30 минут". Это легализует отдых и убирает чувство вины.
- "Помидорки" на отдых без самобичевания. Если у меня перерыв 5 минут, я честно отдыхаю, а не думаю о работе. Раньше я тратил эти 5 минут на то, чтобы корить себя за то, что я не работаю. Глупость несусветная.

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

Продолжать тренировать мышцу "80/20". Перфекционист во мне очень силен😅 Это постоянная борьба, но она того стоит.

Теперь жду ваших историй об эффективности, чтобы стащить пару "рецептов"🌚

#эффективность #продуктивность #выгорание #карьера

Гайд по OpenSource

Как-то я совсем профукал, что у Github есть ГАЙДИЩЕ по OpenSource – https://github.com/github/opensource.guide

Там есть клевые статьи о том:
– как контрибутить
– как запустить свой OSS
– как мейнтейнерам не выгорать
– как искать пользователей

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

А еще на Github есть оч крутой список Community Standarts (прям в Insights проекта), который помогает превратить ваш репозиторий из "сделано на коленке" в "выглядит сурьезно".

В общем, мне нравится, насколько Github ориентирован на OpenSource. Надеюсь, вся эта движня с Microsoft не испортит мою любимую платформу😢

Кстати, если вам интересно, могу закинуть свой чеклист с правилами оформления репозитрия Github и конкретными тулами, чтобы вы могли за один вечер прокачать свои репозитории по всем требованиям GH и даже больше😎

Кажется, AGI будет не в этом году😅

Зарубежные блогеры тоже по чуть-чуть подтягиваются и начинают освещать FastStream

Arjan включил FS в список "неизветные либы, которые вам стоит знать": https://youtu.be/F09EK4ztG34?si=zMi-wiKQhV9e_DET
Обидно, что не осветили вообще никакие фичи фреймворка. Кажется, он сам не особо вчитывался даже в README. Возможно, стоит пересмотреть README, чтобы подсвечивать все важное с первых строк.

А вот у Eduardo более вдумчивый подход – https://www.youtube.com/watch?v=_78VJCs-8DQ

Чувак пилит полноценные двухчасовые стримы, изучает все фичи, готовит примеры кода, делает слайды, разбавляет это своими примерыми и доп материалам, объясняет почему это важно и круто. Кажется, он даже в истрию "двух библиотек" залез. Но я все равно ничего не понял, т.к. стрим на португальском и перевести у меня не получилось😢 Но формат у него крутой

В общем, медленно, но верно растем. Глядишь, скоро 5к звезд наберем

Полный гайд по OpenSource на GitHub

Стартануть свой OSS может быть очень сложно. Не ясно, с чего начать, как он вообще должен выглядеть, как его продвигать. Тут очень помогает насмотренность – ходишь по крупным GitHub репозиториям и делаешь "как у них". Но я избавил вас от такой необходимости и подготовил чек-лист оформления репозитория для старта вашего проекта на GH😎

Основная цель всего этого оформления – сделать репозиторий максимально привлекательным для мимопроходящих людей (чтобы конвертить их в пользователей) и максимально гостеприимным для контрибуторов. Чем раньше вы позаботитесь о своем инструментарии - тем вероятнее в ваш проект будут коммитить другие люди.

1️⃣ README.md - папа и мама вашего проекта. Он должен быть даже раньше кода. Именно по нему юзеры принимают решение – юзать или не юзать. Там обязательно должны быть следующие секции:
– основная идея проекта. 1-3 предложения. Ильяхов в помощь
– основные фичи буллет-поинтами
– как проект установить
– базовый пример использования (код / скрины / что угодно в зависимости от проекта)
– как запускать
– подсветить другие важные фичи
– из прикольного можно добавить аватарки всех контрибуторов, людям будет приятно увидеть себя в списке (пример из репы FS)

2️⃣ Заполнить раздел "Описание" вашего проекта (правый верхний угол репозитория) - именно это описание будет отображаться на превью карточки репозитория по ссылке. Важно для SEO.

3️⃣ Правильно выбрать топики. Делается там же, где и описание. По таким топикам я нашел много OSS проектов – еще один бесплатный канал SEO для вас

4️⃣ LICENSE - ОБЯЗАТЕЛЬНО. Без лицензии ваш проект не более чем игрушка. Никто не будет рассматривать его использование на продакшене. Можете посмотреть шаблоны тут и сравнить их тут. Если у вас нет никаких особых планов - просто воткните MIT. Ну или пивную лицензию (хотя бы полезно)

5️⃣ лейблы (badges / shields) в README - это тоже очень важно. Эти лейблы быстро распознаются юзером и помогают понять, в каком состоянии проект. Почти все можно оформить тут. Там обязательно должно быть:
– последняя версия библиотеки, которую можно скачать (pypi / npm / etc)
– code test coverage - это оч важная цифра для нового проекта. Наличие coverage 95% показывает пользователям, что хотя у вас и не много звезд / скачиваний, вы все равно думаете о качестве. Это дает им какую-то уверенность, что ваш проект можно взять и не обжечься
– количество установок (в день / неделю / месяц) - можно добавить чуть позже, когда будет что показать. Но это тоже отличный способ показать "смотри, нас уже кто-то юзает. Ты тоже можешь".
– поддерживаемые версии языка (python в моем случае). Чтобы юзеры понимали сразу, подходит ли им проект. Или мб он уже устарел на 5 версий от хедлайн и проект скорее мертв, чем жив
– лицензия проекта
– другие пайплайны по вкусу - Sonar, Code Quality, Dependency Review и тд

6️⃣ ДОКУМЕНТАЦИЯ - без этого даже нет смысла запускаться. Сайтик на пару страниц делается на mkdocs с хостингом на GitHub Pages за вечер. Но он нужен. Причем сразу. Посадочной страницей имеет смысл продублировать README репозитория

7️⃣ examples/ примеры кода - пока проект маленький оч удобно держать такую мини-доку прям в коде. Люди смогут дергать куски кода для понимания работы каждой фичи. Они точно это оценят

8️⃣ Настроить CI - форматеры, линтеры, автоматический запуск тестов... OpenSource - это про качество и про контрибуторов. Без CI не будет ни того, ни другого
– также очень важно добавить запуск тестов по крону (раз в сутки / неделю), чтобы отлавливать несовместимости с релизом новых версий ваших зависимостей

9️⃣ CONTRIBUTING - небольшой (или огромный) гайд о том, как запустить ваш проект локально, вносить изменения, запускать линтеры, тесты и тд. Без этого людям тяжело приносить PR'ы. А вам нужна их помощь

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

Рабочая неделя заканчивается, а кому-то даже пора в отпуск🌚

Вестей от меня не ждите до 23го минимум, я буду далеко на природе обниматься с медведями. Ну, разве что где-нибудь сеть поймает😅

А пока оставлю вам прикольное занятие на выходные – позаниматься коучинговыми практиками. В принципе, чем я и сам планирую заняться на природе. Да, я знаю, что нарываюсь на клоунов😅 Но как вы поняли, я фанат темы про эффективность, самомотивацию и личное развитие. Поэтому в последнее время подзалип на канал вот этой дамы:

https://youtu.be/uRg8CiXABWs?si=StuNwPb3dZNqU1j9

Там не без треша, конечно (тема с эзотерикой мне вообще не близка), но в остальном мне нравятся ее идеи и советы.

Например, из видоса выше мне оч понравилось упражнение – расписать всю свою прошедшую жизнь отрезками по 7 лет. 0-7, 7-14, 14-21, 21-28 и тд. Что ты сделал за это время, что с тобой произошло важного, чего достиг, чем сам гордишься. Сначала я не понял, в чем прикол, но решил попробовать. А потом как понял🤯

Мои промежутки 14-21 и 21-28 получились такие насыщенные, что я даже не представлял, как много там поместилось: переезд в несколько городов, смена двух вузов, профессиональный киберспорт, наконец закончил высшее образование, куча конкурсов, статей, увлечений совсем разными темами, построил крепкие отношения, покупка недвижимости, занятие опенсорсом, семейные проблемы... В общем, в каждые 7 лет умещается целая жизнь.

Поэтому теперь я смотрю на следующий отрезок 28-35 не со страхом, а с уверенностью – впереди меня ждет еще одна "целая жизнь" и планы на нее можно строить грандиозные. Я же знаю теперь, сколько всего можно успеть😅 А еще я вижу "тренд", что помогало и мешало мне все эти годы.

На выходных обязательно потратьте 10 минут – очень интересно узнать себя таким вот способом)