
Есть момент, который знает каждый, кто когда-либо делал пет-проект. Ты закончил первую рабочую версию, она запускается, ты горд собой. И тут перед тобой встаёт вопрос: выложить это на GitHub или пусть лежит в папке projects/my_project?
В голове сразу возникают вопросы и сомнения. «Да кому это нужно?», «Это же не фреймворк, звёзд не будет», «Код сырой, вдруг кто-то увидит и посмеётся». И самое коварное: «Если у проекта нет пользователей, то зачем вообще его публиковать?»
Я уже писал о том, почему большинство pet-проектов бесполезны — и вот что интересно: бесполезными их делает не отсутствие звёзд, а отсутствие смысла.
Звёзды — плохая метрика, и это надо принять
Давайте честно. GitHub-звёзды — это социальная валюта, а не инженерная. Проект со звёздами не обязательно хороший, а проект без звёзд не обязательно плохой. То же самое касается и пользователей. Большинство звёзд получают либо утилиты с широкой аудиторией, либо проекты, которые попали в тренд, либо то, что активно продвигали. Твой pet-проект на Java, который решает одну конкретную задачу, в эту категорию не попадает — и это нормально.
Звёзды, как и юзеры, зависят от маркетинга, тайминга и удачи, а не от качества кода. Если ты выкладываешь проект ради звёзд, ты почти наверняка разочаруешься. И это разочарование отобьёт желание делать что-то ещё.
Поэтому первое, что нужно сделать: перестать ждать отдачи от Github. Вообще. Ноль ожиданий — и ты получишь от open-source ровно то, что он может дать.
Публичность делает код лучше
Это самый недооценённый эффект. Когда ты знаешь, что код увидят — пусть даже гипотетический «кто-то» — ты начинаешь писать иначе. Убираешь // TODO, нормально называешь переменные, не оставляешь закомментированные куски. Возникает лёгкий эффект «комиссии».
И это не про страх. Это про то, что делая код видимым всем, ты поднимаешь планку. Даже если проект посмотрят три человека за год, ты пишешь код так, будто его читают сотни людей. А значит, через полгода ты сам сможешь его прочитать. Что, если честно, уже огромная победа.
GitHub — это архив, а не папка на диске
Локальная папка не переживёт переустановку системы, смену ноутбука или просто потерю интереса на пару лет. Git-история с осмысленными коммитами — переживёт. Ты сможешь вернуться к проекту через год и увидеть не «кашу из файлов», а эволюцию решений: вот здесь я выбрал PostgreSQL и объяснил почему, вот здесь переписал слой доступа к данным.
Это честный ответ на вопрос «покажи свой код»
Рано или поздно на собеседовании, в переписке с потенциальным заказчиком или просто в разговоре с коллегой прозвучит: «А можно посмотреть, что ты делал?». И тут есть два варианта. Первый: «Ну, у меня есть пет-проект, но он локально». Второй: ссылка на репозиторий, где видно и структуру, и историю, и README, и то, как ты работаешь. Публичный проект — это не про звёзды. Это про доказательство. Причём не только кода, но и того, что ты умеешь доводить вещи до состояния, в котором их не стыдно показать.
Обратная связь приходит откуда не ждёшь
Если у проекта нет звёзд, это не значит, что им никто не пользуется. Иногда приходит один issue — от человека, который наткнулся на твой репозиторий по поиску и реально попробовал запустить. И этот один issue может дать больше, чем сотня звёзд: он покажет реальную проблему, о которой ты не думал.
Не жди сообщества. Жди одного человека. Часто этого достаточно, чтобы проект стал лучше.
Это акт смелости, и он тренируется
Выложить код, который не идеален, — это маленький, но настоящий акт смелости. И он полезен сам по себе. Потому что дальше ты выложишь второй проект, потом третий, и постепенно страх «а что подумают» перестанет тебя останавливать. А это качество, которое пригодится далеко за пределами GitHub.
«А если код простой и мне за него стыдно?»
Стыдный код — это нормально. У всех есть проекты, за которые сейчас немного неловко. Это не повод их прятать, а доказательство того, что ты вырос. Сравни код, который ты написал год назад, с тем, что пишешь сейчас. Если разницы нет — вот это действительно повод задуматься.
Если совсем некомфортно, есть промежуточные варианты:
- сделать репозиторий публичным, но без анонсов и продвижения
- выложить проект как есть, но добавить в README честную заметку: «ранняя версия, пишется для себя»
- начать с малого — выложить не весь проект, а одну полезную утилиту
Главное — не ждать «идеального момента». Его не будет.
Что делать вместо погони за звёздами
Если звёзды не цель, то на что направить энергию? Вот несколько вещей, которые дают реальную отдачу:
- Напиши нормальный README. Не «мой проект на Java», а что делает, зачем, как запустить, какие технологии. Это единственное, что прочитает случайный посетитель
- Веди осмысленную историю коммитов. Не «fix», «update», «ещё немного», а что именно и почему изменилось
- Добавь лицензию. Даже если проект только для себя — это знак, что ты понимаешь, как работает open-source
- Опиши, чему научился. Хотя бы в разделе README или в отдельном NOTES.md. Через год это будет твоей личной капсулой времени
Не удаляй проект, если он «не взлетел». Он уже выполнил свою функцию: ты на нём учился.
Вместо вывода
Звёзды на GitHub — это приятный бонус, но не цель и не мерило. Ценность публичного пет-проекта в другом: в дисциплине, которую он даёт, в архиве, который остаётся, в доказательстве, которое можно предъявить, и в смелости, которую ты тренируешь.
Выкладывай. Даже если звёзд не будет. Особенно если звёзд не будет. Потому что проект, который лежит в папке на диске, не существует для мира. А проект на GitHub — существует. И этого уже достаточно.