# Introduction
Ceci est une compilation de conseils et de ressources nécessaire pour faire la promotion d'un projet opensource que j'ai eu la chance de trouver sur Github. J'espere qu'il sera utile pour toute équipe de developpeur qui compte démarer la promotion de leur logiciel Opensource.
Ce cheat sheet résume les étapes importantes à suivre pour promouvoir un projet open-source dans les meilleures conditions. >Il est possible d’afficher des informations supplémentaires pour un élément de la liste en cliquant dessus.
# 1. 🎢 Préparation
👌 S'assurer que le projet soit assez mature
Assurez-vous que votre projet soit stable et possède un minimum de fonctionnalités intéressantes pour accrocher les visiteurs.
😎 Choisir un nom cool pour son projet
Choisissez un nom que vos visiteurs pourront facilement retenir.
💅 Soigner la présentation du README
Le README est la première chose que les visiteurs verront sur la page de votre projet. Travaillez la présentation pour qu'elle soit simple, jolie et agréable à lire. Vous trouverez des exemples de README soignés ici.
💪 Mettre en avant les points forts du projet
Identifiez les points forts de votre projet et mettez-les en avant de manière à ce que ce soit la première chose que voient vos visiteurs.
✨ Mettre une démo du projet à disposition
Vos visiteurs voudront comprendre rapidement à quel besoin répond votre projet et comment il fonctionne. Mettre une démo à disposition est un excellent moyen de satisfaire vos visiteurs. Le format de la démo peut être :
- un GIF animé
- un lien vers une démo en ligne
👌 L'installation et l'utilisation du projet doivent être les plus simples possibles
Vous risquez de perdre des visiteurs si le projet n'est pas simple à installer ou à utiliser.
📘 Créer une documentation soignée et structurée
Créer une bonne documentation est probablement l'étape la plus importante. Si votre documentation n'est pas longue, vous pouvez l'inclure directement dans votre README. Si celle-ci est volumineuse, le mieux sera de l'héberger sur un site différent. Certains projets open-source comme vuepress permettent de créer rapidement une jolie documentation.
# 2. 📢 Communiquer le projet
⭐ Mettre en confiance les futurs visiteurs avant de publier sur les réseaux sociaux
La plupart des visiteurs regarderont le nombre de stars du projet avant de l'utiliser. Plus votre projet possède un nombre important de stars, plus son indice de fiabilité sera élevé. N'hésitez pas à demander à vos proches, collègues et amis de vous aider à améliorer la crédibilité de votre projet en ajoutant une star.
↗️ Partager le projet sur les réseaux sociaux et les plateformes spécialisées
Voici quelques plateformes sur lesquelles vous pourriez partager votre travail :
📃 Écrire des articles en mentionnant le projet
Écrivez des articles et citez votre projet. Le sujet de l'article peut être lié à la stack technique que vous avez utilisée, les problèmes que vous avez rencontrés, etc. Postez sur les plateformes de publication :
🎤 Présenter le projet à des conférences/meetups
La présentation de votre projet à des conférences et meetups est un excellent moyen d'améliorer sa visibilité.
🎥 Enregistrer et publier des vidéos de présentation du projet
Enregistrez une vidéo n'est pas un exercice facile, cependant c'est l'un des moyens les plus efficaces pour rendre votre projet populaire.
🕐 Choisir le meilleur moment pour publier sur les réseaux sociaux
Habituellement, le meilleur moment pour lancer une communication est en milieu de semaine. Ne faites pas de communication pendant les périodes de vacances ou le week-end.
🗑 Ne pas spammer les plateformes avec la promotion du projet
Ne publiez pas deux fois sur la même plateforme. Votre communication pourra être considérée comme du spam et causer de la mauvaise publicité pour votre projet.
# 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 welcomeougood 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
Contributorssur 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).
Bonne Lecture!