# Как вывести проект в тренды Github

Когда я пишу эту статью, у [TextDistance](https://github.com/orsinium/textdistance) 1000 звёздочек. А значит, пора подводить итоги.


## Источники трафика

1. Стартовать с [Reddit](https://www.reddit.com/) очень удобно. В [/r/Python](https://www.reddit.com/r/Python/) сообщество дружелюбное, в минус почти никого не уводят.
1. Посетителей с reddit было 701, в то время как с github -- 1 528. Это были люди, просматривающие тренды. А значит, главное -- выйти в тренды, а там уже всё пойдёт по накатанной.
1. Небольшую прибавку дают ссылки, опубликованные в Twitter разными людьми. Но основная польза от твиттера -- возможность получить какую-то обратную связь. Хотя в Reddit коммуникация идёт более активно.


## Приводим репозиторий в порядок

1. README репозитория должно выглядить максимально круто. Большинство людей читают только его. Я посмотрел разные репы, и больше всего мне понравился [Keras](https://github.com/keras-team/keras). Красиво, кратко, понятно.
1. Баджики подтягиваем с [shields.io](https://shields.io/), но злоупотреблять не стоит. Берем результаты CI, берем показатель покрытия тестами, если покрытие хорошее, лицензию, оценку качества кода (для Go, JS и многих других языков есть такие сервисы), статус проекта. Если баджиков много, некоторые проекты выносят их в отдельную таблицу.
1. [Лицензия](https://habrahabr.ru/post/243091/) важна, люди спрашивают о мотивации при её выборе. Я использую LGPL 3.0, но, кажется, надо переехать на Apache 2.0. Выбрать лицензию для себя можно на [choosealicense.com](https://choosealicense.com/licenses/).
1. Тесты обязательно нужны. Вы полюбите тесты. И CI тоже. Используйте [Travis CI](https://travis-ci.org/). Он будет сам запускать тесты, сообщать на почту о проблемах, показывать результаты везде в интерфейсе гитхаба, да и вообще, умеет не только в тесты. например, можно автоматически деплоить новые версии паета на PyPI.
1. Логотип тоже нужен. Казалось бы, деталь незначительная, но на самом деле очень важная. Чем больше проект похож на крупные и серьезные репозитории, тем выше к нему доверие.
1. Возможности проекта важнее его внутренностей. Простите, но это так. Я видел в трендах ужасный код, спрятанный за хорошими описаниями.
1. Проект должен быть сразу максимально хорош. Не нужно рекламировать что-то ещё в сыром состоянии. Будет сложно привлечь людей крупным апдейтом проекта, который они уже увидели и составили первое впечатление. Первое впечатление самое важное.


## Важные детали

1. Отвечайте на комментарии и issue. Будьте вежливы и отзывчивы, чтобы в ответ получить хорошее отношение к себе и своему проекту.
1. Публиковать надо в начале недели, чтобы подольше продержаться на хайпе. Самая высокая активность в среду-четверг, когда люди на работе, всё уже не так горит, как в начале недели, и ещё не иссякли силы, как в конце недели. На выходных нормальные люди отдыхают от вот этого всего, это мы опенсурсим 24 на 7, поэтому если что-то опубликовать в субботу или воскресенье, никто не заметит.