Автор оригинала: FreeCodeCamp Community Member.
Toast Ui
Одинокий открытый источник
Мы разрабатываем Markdown Wysiwyg редактор Проект в течение трех лет, с его первым фиксацией в марте 2015 года. Я пошел на работу 30 декабря 2017 года, чтобы выпустить версию 1.0 и публиковать его на NPM Отказ
В то время репозиторий был таким же тихим, как воздух в офисе в конце года. Проблема опубликована один раз в течение нескольких месяцев, и, казалось, старалась сказать, что «этот проект является открытым исходным кодом». Он получил ровно 160 звезд GitHub в течение трех лет, а запрос на тягу было трудно ожидать.
Не удивительно. Даже из Google и Facebook , есть проекты с открытым исходным кодом, которые не имеют участников. Я предполагаю, что некоторые из вас, возможно, испытали разочарование, так как ваш драгоценный открытый источник не пошел ни к тому, кроме пустоты. Более того, мы используем для использования Github как наш бесплатный репозиторий Git. Не так ли?
Поскольку выпуск 1.0 я хотел больше людей узнать об этом проекте. Я верил, что этот проект стоил больше, чем то, что он выглядел в этой точке. Я сделал несколько вещей, чтобы достичь этого, и в результате он получил 2000 звезд за 4 дня и 3000 звезд в неделю! Сейчас у него более 5500 звезд и полных вопросов и потянутых запросов. Это произошло всего за один месяц.
Я написал эту статью, чтобы поделиться своим опытом за последний месяц. Я также покажу вам номера, которые я записал, когда это возможно. Я надеюсь, что это может помочь вам сделать свой проект с открытым исходным кодом, полный участников.
Хороший файл readme зарабатывает звезды
Несмотря на почти три года, мы развиваем наш редактор, никто не был заинтересован в этом. Было неизбежно, поскольку документы были бедными.
Даже для стиральной машины вы захотите прочитать руководство один раз. Вы должны предоставить еще больше документов для вашего проекта.
Файл readme описывает сущность проекта. Демо демонстрирует, что он готов к использованию. Примеры должны быть первым шагом в различных требованиях. Учебники должны помочь кому-нибудь начать.
Если вы пропустите любую из этих документов, пользователи будут отказаться от вашего проекта. Выдвижение исходного кода не делает ваш проект с открытым исходным кодом.
Среди документов readme играет важнейшую роль. Недостаточно просто перечислить несколько документов. Вы, я и большинство разработчиков ленивы. Большинство посетителей просто прокручивают примерно дважды на README и оставьте, если они не заинтересованы. Итак, файл readme должен предоставить причину, почему разработчики хотят ваш проект.
Давайте посмотрим, какая разница обновляет файл Readme. Звезды GitHub на самом деле не только закладки для посетителей. Но количество звезд GitHub рассказывает вам, сколько посетителей заинтересованы в вашем проекте.
В таблицах ниже количество звезд и уникальных посетителей, которые я записал до и после опубликования редактора Toast UI 1.0.
Не было никаких добавленных функций или не обновляемых. Были только обновления документов – в основном в файле README – и некоторых рефакторинга. Следующие номера полностью привели к изменениям в файле README.
Это было бы лучше, если бы у нас была запись с самого начала проекта. Но я только что записал цифры, чтобы проверить тенденции. Я не могу помочь этому в этот момент. Итак, давайте просто посмотрим на цифры, и я оставлю его на чувству твоего кишечника.
Перед обновлением файла readme около 4% всех посетителей дали звезду. Удивительно, что после обновления файла readme около 20% всех посетителей дали звезду. Обновление файла Readme, этот проект получил почти в пять раз больше звезд От посетителей!
Все говорят, что файл readme важен. Но кто знал, что это будет иметь такое огромное значение? Я также был удивлен, увидев это. Если вы хотите иметь вклад в проект, вы должны написать хороший привлекательный файл Readme больше всего на свете.
Вы можете легко найти статьи о том, как написать приятный файл Readme в Google. Также хорошая идея изучить readmes в других проектах, перечисленных на Awesome Readme Отказ
Распространять слово вокруг сообщества
Наш проект был около десяти посетителей в день. Если вы усердно работали над своими документами, настало время, чтобы люди знали о вашем проекте.
Конечно, было бы лучше, если кто-то другой будет распространять слово о вашем проекте вместо вас. Но вы должны начать это самостоятельно. Если ваш проект нигде не связан, он не будет показан в поисках Google. Никто не будет знать, что ваш проект существует.
Поговорите о своем проекте каждый шанс у вас есть
Ответьте на вопросы на Stackoverflow и Квора Отказ Поговорите с людьми в Группы Facebook Отказ Отправить ссылку на Hackernews и Reddit Отказ И спросить Новостные бюллетени Чтобы опубликовать свой проект.
Вы также можете попросить сообществ помочь вам с вашим проектом, а также рассказать им о вашем проекте.
Но не спам их слепо. Общины и СМИ имеют разные личности. Spamming ваш проект без понимания каждого сообщества может привести к удалению вашей публикации или просто игнорировать. В худшем случае вы можете быть запрещены от этих сообществ, или ваш проект может получить плохую репутацию.
Будьте активны в каждом сообществе, чтобы понять их. Знание сообществ не просто хорошо для PR. То, что вы учитесь у них, тоже помогут ваши проекты.
Однажды продавец сказал мне:
Я согласен сто процентов на этом. И я думаю, что мы должны сделать то же самое для нашей работы.
Как я обновил файл Readme, я попросил их просмотреть документ. И, к счастью, два человека отправили запрос на тягу после рассмотрения нового README. Я уверен, что двое из них больше заинтересованы в нашем проекте, чем любые другие посетители. Могу поспорить, что они также ударили звезду на нашем проекте.
Узнайте Github Explore
GitHub – лучшее место, чтобы получить ваши участники. Если ваш проект находится на Github, не смотрите слишком далеко, и сначала узнайте больше об этом. В верхней части GitHub вы всегда можете найти меню, которое следует за вами с милым восьмикатом. Исследуйте это то, что мы должны обратить внимание. Страница показывает разработчики полезными и интересными проектами с открытым исходным кодом.
Explore дает вам возможность продемонстрировать ваш проект на 24 миллиона пользователей Github Отказ Вот почему вы должны поддерживать свой проект с открытым исходным кодом на GitHub.
Другие услуги также отлично, поэтому не поймите меня неправильно. Я очень долго использовал Bitbucket для управления личными проектами в частном порядке. Gitlab также имеет действительно приятные функции, которые иногда работают лучше для меня, чем Github в последние годы. Тем не менее, проекты с открытым исходным кодом должны поддерживаться на GitHub, чтобы получить посетителей от изучения.
Посмотрите, какой проект есть, выделите, каковы хорошие части этих проектов, и как идет текущая тенденция. Если вы еще не видели страницу Explore, пришло время проверить это. Здесь вы можете узнать, что вам нужно сделать, чтобы сделать ваш проект лучше.
Когда вы открываете эту страницу, вы увидите Коллекции , Темы и Тенденция Вкладки – каждый из этих списков приятных проектов с открытым исходным кодом. Среди них мы рассмотрим тенденцию и темы. Мы не можем помочь с коллекциями, так как он отдается GitHub.
Стимулы посетителей от Github Trending
Раздел Trending на главной странице Explore показывает проекты, которые получили наибольшее количество звезд, на которых на всех языках. Вставать там было бы очень сложно.
Но вам не нужно сдаваться. Узкий диапазон языка и даты, затем посмотрите на проекты в более низких рядах. Там будет реалистичное число, которое ваш проект также может достигать.
Сосредоточьтесь на посетителях в течение определенных дней, чтобы получить список, привлекая каждое сообщество, в котором вы находитесь. Если вы можете собрать достаточно звезд, ваш проект также может быть в списке Trending. Количество звезд, которые вы получаете, зависит от языка вашего проекта, дня недели и так далее.
Если вы выпустили новый проект или добавленные функции в проект, это идеальное время, чтобы выложить его там. Не разочаровываться, даже если ваш проект перечислен низкий. Ваш проект все равно получит дополнительные посетители. Подумайте о секции Trending как стимул для посетителей на основе вашего ранга.
График выше представляет собой разбивку посетителей в Github Insight после того, как я распространяю слово в различных общинах 10 января. Ссылаясь на сайты в Github Insight дает значения из двухнедельного периода, поэтому вам нужно сделать некоторые расчеты, чтобы получить нужные номера.
10 января – один день – почти все посетители пришли из моих собственных сообществ. К счастью, небольшая часть GitHub.com в графике показывает, что наш редактор был в списке тенденций. На следующий день, 11 января, GitHub уже приносил в половину трафика. Это хороший стимул, чтобы быть в списке тенденций.
На следующий день 12 января редактор был записан как тенденция № 1 сегодня на всех языках. Большинство посетителей пришли из Github. С этого дня посетители, приезжающие из постов, я написал, значительно уменьшился. С другой стороны, поскольку видимость увеличилась, посетители появлялись из неожиданных рефереров.
На следующий день, 13 января большинство посетителей пришли из Github. Редактор записал 2000 звезд в этот день, Четыре дня После того, как он был опубликован на общинах. Хотя рост уменьшился с тех пор, месяц позже Тенденции на этот месяц все еще приносит новым посетителям.
Устойчивые посетители из темы GitHub
Темы показывают проекты в порядке количества звезд в теме.
Это означает, что после того, как ваш проект будет достаточно звезд, которые будут перечислены на тему, он все еще может получить посетителей через тему, даже если ваш проект не соответствует тенденции.
Там не так много посетителей из списка темы, как от тенденции. Но это все еще стоит.
Я видел много проектов, которые не имеют никаких тем. Посмотрите на изображение выше, чтобы увидеть, где вы можете настроить темы в вашем проекте. Вы можете настроить любые темы, которые вы хотите.
Тем не менее, Github управляет списком именем Рекомендуемые темы Отказ Поэтому лучше выбрать соответствующие темы из представленных тем, чтобы получить больше посетителей.
Кроме того, количество звезд, необходимых для перечисления сверху, значительно варьируется в зависимости от тем.
Возьмите в тему JavaScript в качестве примера. Есть проект по размеру динозавра, как FreeCodeCamp (Hello Guys?), Bootstrap, React, Vue и так далее. Это делает его примерно в 100 раз сложнее, чтобы получить ваш проект в этом списке.
Наш редактор занимает 10-е место на теме усадьбы с звездами 5.4K. Посмотрите на темы и выберите темы, которые не слишком конкурентоспособны.
Лучшая одна строка для вашего проекта Описание
Давайте найдем описание на изображении выше снова. Каково описание проекта для вашего проекта? Я написал описание нашего редактора как длинную версию названия (это плохое представление). Вы придумали свою линию? Тогда давайте посмотрим на следующее изображение.
Это то, что наш проект выглядит на тенденции и темах. Попробуйте посмотреть на это с точки зрения посетителей. Существует организация, имя, фотографии участника и так далее. Единственная полезная информация, чтобы определить, можно ли нажать или нет – это описание.
Описание должно быть лучшая одна строка для описания вашего проекта.
Окончательное слово
Написать документы. Быть активным в общинах. Используйте инструменты GitHub.
Советы, которые я поделяю в этой статье, поможет вам сделать ваш проект лучше как открытый источник (в дополнение к получению большего количества звезд).
Но эти советы не могут сделать ваш проект популярным без ценности самого проекта. Я надеюсь, что эта статья поможет вам найти вкладчиков, которые заслуживают вашего проекта.
У меня был возможность написать эту статью, потому что бывшие сопровождающие ( Shiren , Junghwan ) Кто сделал отличную работу для этого проекта. Я считаю, что этот проект уже имел ценность, которое у него сегодня. И советы в этой статье помогли нам достичь остальных.
В прошлом месяце у меня был действительно особый опыт в качестве разработчика. Я хотел бы поблагодарить Toast Ui семьи и Добрать! Команда Для всей вашей поддержки!
Если вы заинтересованы в Toast Ui редактор Я рекомендую вам попробовать Добрать! слишком. Он поставляется с редактором и бесплатным для менее чем 100 сотрудников. Пусть редактор Toast Ui будет с вами?
Удовольствие работать вместе, дверный! Почта, выпуск трекер и чат, любой может легко опубликовать свою задачу и сотрудничать с гостями, а также членами проекта. Doveray.com NNENT/TUI.EDITOR tui.editor – ?? Markdown Wysiwyg Editor. GFM Standard + Chart & Uml Extensible.gi thub.com.
Первоначально опубликовано в Toast Meetup написано Kyuwoo Choi?