Большинство авторов смотрят на свой проект «изнутри». Вам кажется, что всё очевидно: как развернуть окружение, где лежит конфиг и зачем вообще нужна эта библиотека.

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

1. Что это за штука?

2. Решит ли она мою проблему?

3. Насколько сложно её запустить прямо сейчас?

Если README не отвечает на эти вопросы, то вкладка закрывается. Навсегда.

Кстати, о взгляде со стороны:

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

Поделится проектом и получить разбор: t.me/OpenSource_Chat

Где именно теряются люди

README есть, но он написан скорее “для себя”: без нормального объяснения, без примеров, без ощущения ценности. Инструкции запуска либо отсутствуют, либо предполагают, что человек уже знает половину контекста. CONTRIBUTING.md нет, или он формальный. Issues есть, но непонятно, с чего вообще можно начать.

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

Почему код здесь вообще не главный

Есть соблазн думать, что всё упирается в качество кода. Что если сделать “лучше”, “чище” или “правильнее”, то люди сами придут. На практике это почти не работает.

Большинство людей даже не доходят до кода. Они принимают решение раньше на уровне первого впечатления. По сути, README выполняет роль лендинга. Это первая точка контакта с проектом. И у него есть буквально 20–30 секунд, чтобы объяснить ценность и снизить порог входа. Если этого не происходит, человек не будет разбираться глубже. Не потому что ленивый, а потому что у него есть десятки других репозиториев.

А open source начинает жить только тогда, когда в него приходят другие люди. Когда появляются вопросы, комментарии, предложения, pull request’ы. Когда кто-то, кроме вас, пытается этим воспользоваться. До этого момента проект существует, но не развивается.

Что реально меняет ситуацию

Самое простое и одновременно самое недооценённое действие посмотреть на проект глазами другого человека.

Не как автор, а как пользователь, который впервые оказался на странице.

Попробовать честно ответить на вопросы:

• понятно ли, что это за проект

• есть ли причина им воспользоваться

• можно ли быстро его запустить

• есть ли очевидный способ сделать первый вклад

И здесь почти всегда всплывают вещи, которые изнутри просто не видны.

Если хотите поделится своим проектом

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

Присоединиться: t.me/OpenSource_Chat