Как мы подняли репозиторий в топ Гитхаба за два дня (medium.freecodecamp.com) 25 февраля 2017
Разработчики flask-base рассказывают, как они продвигали свой проект.
Самой важной частью продвижения было создание хорошего README.
README — это первое, что видят посетители репозитория. Он должен отвечать на все их вопросы. У популярных проектов README обычно строится по такой структуре:
- Название. Можно нарисовать логотип, тогда проект будет казаться более серьезным.
- Короткое описание. Оно должно помещаться в твит. Ради этого можно пожертвовать деталями.
- Бейджи, которые показывают качество кода. Когда значки говорят, что билд зеленый, тестовое покрытие высокое, а статический анализ не находит проблем, это сразу вызывает доверие. Пользователю не приходится заглядывать в исходники, чтобы убедиться, что код написан хорошо.
- Ссылка на документацию, которая рассказывает, как пользоваться проектом. Написать хорошую документацию тяжело, но критически важно для успеха проекта.
- Список фич. Не обязательно полный, оптимальный размер — до десяти.
- Пример работы. В идеале это должна быть гифка, которая показывает, как работает проект. Ничего страшного, если даже на гифке будет просто показана консоль. Картинка произведет большее впечатление, чем если написать то же самое текстом.
- Инструкции по установке с командами, которые пользователь должен ввести, чтобы на его компьютере всё заработало.