12 KiB
Folha de dicas : Promover um projeto de código aberto
Esta folha de dicas resume os passos importantes a seguir para promover um projeto de código aberto nas melhores condições. É possível exibir informações adicionais para um item da lista clicando nele.
Idiomas disponíveis :
Falta um idioma? Você acha que é possível melhorar esta folha de dicas? Contribuições são bem-vindas !
1. 🎢 Preparação
👌 Verifique se o projeto está maduro o suficiente
Certifique-se de que o seu projecto é estável e tem um mínimo de características interessantes para envolver os visitantes.
😎 Escolha um nome legal para o seu projeto
Escolha um nome que seus visitantes possam facilmente lembrar.
💅 Cuide da apresentação do README
O README é a primeira coisa que os visitantes vêem na página do seu projeto. Trabalhe na apresentação para torná-la simples, bonita e agradável de ler. Você encontrará exemplos de README tratados aqui.
💪 Destacar os pontos fortes do projeto
Identificar os pontos fortes de seu projeto e colocá-los para a frente de modo que é a primeira coisa que seus visitantes vejam.
✨ Apresentar uma demonstração do projeto
Seus visitantes vão querer entender rapidamente quais são as necessidades do seu projeto e como ele funciona. Fornecer uma demonstração é uma ótima maneira de satisfazer seus visitantes. O formato da demonstração pode ser:
- um GIF animado
- um link para uma demonstração online
👌 A instalação e o uso do projeto devem ser o mais simples possível
Você pode perder visitantes se o projeto não for fácil de instalar ou usar.
📘 Crie uma documentação clara e estruturada
Criar boa documentação é provavelmente o passo mais importante. Se sua documentação não for longa, você poderá incluí-la diretamente no seu README. Se for volumoso, o melhor será hospedá-lo em um site diferente. Alguns projetos de código aberto como o vuepress podem criar rapidamente uma boa documentação.
2. 📢 Comunicar o projeto
⭐ Confiar futuros visitantes antes de publicar nas redes sociais
A maioria dos visitantes olhará para o número de estrelas no projeto antes de usá-lo. Quanto mais estrelas o seu projecto tiver, maior será o seu índice de fiabilidade. Não hesite em pedir a seus parentes, colegas e amigos para ajudá-lo a melhorar a credibilidade do seu projeto adicionando uma estrela.
↗️ Compartilhar o projeto em redes sociais e plataformas especializadas
Aqui estão algumas plataformas nas quais você pode compartilhar seu trabalho :
📃 Escreva artigos mencionando o projeto
Escreva artigos e cite seu projeto. O assunto do artigo pode estar relacionado com a pilha técnica que utilizou, os problemas que encontrou, etc. Postar nas plataformas de publicação:
🎤 Apresentar o projeto em conferências / encontros
Apresentar seu projeto em conferências e encontros é uma ótima maneira de melhorar sua visibilidade.
🎥 Gravar e publicar vídeos de apresentação do projeto
Gravar um vídeo não é um exercício fácil, mas é uma das maneiras mais eficazes de tornar seu projeto popular.
🕐 Escolha o melhor momento para publicar nas redes sociais
Normalmente, a melhor altura para iniciar uma comunicação é no meio da semana. Não comunicar durante os períodos de férias ou fins de semana.
🗑 Não faça spam nas plataformas com promoção do projeto
Não publique duas vezes na mesma plataforma. Sua comunicação pode ser considerada spam e causar má publicidade para o seu projeto.
3. 🤝 Garder les utilisateurs
🆕 Mettre régulièrement à jour le projet
Maintenez et améliorez votre projet en publiant de nouvelles versions. N'oubliez pas de générer les changelogs associés.
❗ Maintenir le projet et traiter les issues ouvertes
Ne laissez pas les issues sans réponse. Soyez courtois et sympathique avec les personnes qui ont pris le temps d'ouvrir des issues. 😉
🙏 Inviter les utilisateurs à contribuer
Un projet en bonne santé est un projet qui possède une communauté et des contributeurs. Montrez à vos utilisateurs que leur aide est la bienvenue en taggant certaines issues avec les labels
contribution welcome
ougood first issue
. Vous trouverez plus d'information sur les labels en cliquant ici.
🏆 Récompenser les contributeurs
Certains projets open-source comme gatsby récompensent leurs contributeurs avec des goodies. Si vous n'en n'avez pas les moyens, faites une publication (sur twitter ou d'autres plateformes) qui mentionne la contribution et son auteur afin de le remercier (ex. : Post sur twitter). Vous pouvez aussi ouvrir une section
Contributors
sur votre README afin d'afficher publiquement votre gratitude envers vos contributeurs ou encore les mettre en avant sur le site ou la documentation de votre projet.
💬 Ouvrir un chat pour la communauté du projet
Les issues Github ne sont pas toujours la meilleure manière de communiquer avec vos utilisateurs. Si nécessaire, vous pouvez ouvrir un chat pour discuter avec eux :
🔙 Demander des retours utilisateurs
Les retours des utilisateurs sont un excellent moyen d'améliorer votre projet. Vos utilisateurs ont probablement un tas d'idées qui pourraient rendre votre projet meilleur.
❤️ Montrer ce que les autres utilisateurs ont créé avec votre projet
Les visiteurs accorderont plus facilement leur confiance s'ils voient des cas concrets d'utilisation (ex. : vuepress gallery).
🙏 Montrez votre support
N'hésitez pas à mettre une ⭐ si ce projet vous a aidé.
❤️ Contributeurs
Merci à tous les formidables contributeurs:
Franck Abgrall 📖 |
Thomas Betous 📖 |
Eric Briand 📖 |
Faustine Godbillot 📖 |
Benjamin Plouzennec 📖 |
Johan Bonneau 📖 |
Benjamin Petetot 📖 |
NickHatBoecker 🌍 |
Claire Martinez 🌍 |
André Gama 📖 |
Mathias Bernardeau 📖 |
Ce projet suit la spécification all-contributors. Les contributions de tout type sont les bienvenues !