Comment mieux impliquer les utilisateurs qui ont joué mon projet sur GitHub?

19

J'ai récemment mis en place un projet, appelé Hebel , sur lequel j'ai travaillé sur GitHub. C'est un cadre pour l'apprentissage en profondeur accéléré par GPU écrit en Python et Nvidia CUDA. J'ai posté à ce sujet sur Google+ et peu de temps après, il a été repris sur Hacker News et est devenu légèrement viral pendant quelques jours. Plus tard, j'ai également posté à ce sujet dans le sous-programme Machine Learning et, dans l'ensemble, mon projet a remporté 822 étoiles et 47 fourchettes sur GitHub, ce qui était vraiment exaltant. 822 étoiles signifie que mon projet est dans le top 200 des projets Python sur GitHub et en fait a plus d'étoiles que certains projets Python de haut niveau et largement utilisés comme virtualenv.

Malgré l'intérêt considérable pour mon projet, je suis très déçu de l'engagement réel que j'ai vu jusqu'à présent. Aucune des 47 fourchettes de mes projets n'a jamais fait de commits, je n'ai reçu aucune demande de pull et seulement trois numéros soumis ont été soumis par deux personnes. Il semble que mon projet soit potentiellement très intéressant pour beaucoup de gens, mais ils ne le lancent qu'une fois et ne le reviennent plus jamais, ni ne l'utilisent de façon continue.

Comment puis-je améliorer l'engagement afin que les utilisateurs soumettent des bogues ou des demandes d'amélioration ou que les contributeurs soumettent des modifications?

Oceanhug
la source
5
C'est le genre de projet que beaucoup considéreront comme cool, mais ne l'utilisera pas lui-même.
CodesInChaos
1
Je suppose que la plupart des gens considèrent votre projet comme un signet, car en parcourant le fichier readme.md, ils lisent des mots à la mode (Python, CUDA) qui sonnent bien pour jouer avec à un stade ultérieur. Je suis un développeur de logiciels senior, mais même après avoir regardé votre page de projet github pendant quelques minutes, je n'ai qu'une vague idée de quoi il s'agit. Si vous voulez que les gens contribuent à votre projet, mon conseil - tout à fait non scientifique - serait de le présenter d'une manière que quelqu'un qui ne connaît pas beaucoup les réseaux de neurones (et toutes les autres choses expertes) peut également comprendre.
ssc

Réponses:

25

Vous y avez travaillé très dur. Félicitations pour toute l'attention, mais désolé ce n'est pas engageant.

La première chose que je remarque, c'est qu'il n'y a aucun problème. Pour inciter les gens à s'engager, vous devez être visible dans leur fil d'actualités GitHub. Lorsque vous démarrez un problème, il apparaîtra aux personnes qui suivent le projet (pas à celles qui l'ont mis en vedette). La taille de votre communauté est donc d'environ 80 abonnés. Ce ne sont que les followers auxquels vous devriez penser. Forkers peut simplement saisir le code et s'éloigner, et les étoiles sont un peu comme des signets. Un abonné sera informé des nouveaux problèmes.

Essayez d'ouvrir des problèmes simples.

ÉDITER:

Votre fichier README.md est votre publicité pour le dépôt. C'est la première chose que les gens liront et la première chose vers laquelle ils se tourneront pour obtenir de l'aide. 2/3 de votre fichier Lisez-moi parle de ce qu'est Hebel dans une langue techniquement spécifique (c'est-à-dire que je n'ai aucune idée de ce dont vous parlez). Le tiers inférieur n'a que quelques instructions d'installation.

L'une des choses les plus difficiles que j'ai trouvées avec GitHub est d'obtenir des projets pour faire ce que l'auteur prétend. L'installation, l'exécution et le travail prennent le plus de temps. Si quelqu'un obtient votre dépôt mais ne peut pas le faire fonctionner, vous n'aurez jamais de demande de pull.

Je ne peux que soupçonner que c'est la cause.

Révisez votre fichier Lisez-moi et placez les instructions de démarrage / d'installation tout en haut. Ainsi, les gens peuvent se lancer et commencer.

Deuxièmement, incluez une sorte d'échantillon / exemple qu'ils peuvent démarrer rapidement et qui démontre les avantages du projet.

Reactgular
la source
3
Sans aucun doute. Si vous avez une section dans le fichier README qui ressemble à "Contribuer: cloner le référentiel, exécuter ce script de construction en ligne, ajouter une fonctionnalité, ajouter un test, soumettre un PR", alors je pense que vous ferez beaucoup de progrès. Il y a des tonnes d'inertie qui se jettent dans le projet de quelqu'un d'autre. Rendez-le facile pour eux!
Daniel