¿Cómo puedo involucrar mejor a los usuarios que protagonizaron mi proyecto en GitHub?


19

Recientemente presenté un proyecto, llamado Hebel , en el que he estado trabajando en GitHub. Es un marco para el aprendizaje profundo acelerado por GPU escrito en Python y Nvidia CUDA. Publiqué sobre ello en Google+ y poco después fue recogido en Hacker News y se volvió un poco viral durante unos días. Luego publiqué sobre eso nuevamente en el subreddit de Machine Learning y en total mi proyecto recogió 822 estrellas y 47 bifurcaciones en GitHub, lo cual fue realmente emocionante. 822 estrellas significa que mi proyecto se encuentra entre los 200 principales proyectos de Python en GitHub y, de hecho, tiene más estrellas que algunos proyectos de Python de alto perfil y ampliamente utilizados como virtualenv.

A pesar del considerable interés por mi proyecto, estoy muy decepcionado con el compromiso real que he visto hasta ahora. Ninguno de los 47 tenedores de mis proyectos ha tenido ningún compromiso, no he recibido ninguna solicitud de extracción, y solo tres cuestiones enviadas fueron enviadas por dos personas. Parece que mi proyecto es potencialmente muy interesante para muchas personas, pero solo lo protagonizan o lo bifurcan una vez y luego nunca vuelven a él o lo usan de forma continua.

¿Cómo puedo mejorar el compromiso para que los usuarios envíen errores o soliciten mejoras o que los contribuyentes envíen cambios?


55
Es el tipo de proyecto que muchos considerarán genial, pero en realidad no lo usarán ellos mismos.
CodesInChaos

1
Supongo que la mayoría de las personas protagonizan su proyecto como un marcador porque mientras hojean el archivo readme.md, leen algunas palabras de moda (Python, CUDA) que suenan geniales para jugar en una etapa posterior. Soy un desarrollador senior de software, pero incluso después de mirar su página de proyecto github durante un par de minutos, solo tengo una vaga idea de qué se trata todo esto. Si desea que las personas contribuyan a su proyecto, mi consejo, completamente no científico, lo presentaría de una manera que alguien que no sabe mucho sobre redes neuronales (y todo lo demás experto) también puede entender.
ssc

Respuestas:


25

Has trabajado muy duro en esto. Felicidades por toda la atención, pero lo siento, no es atractiva.

Lo primero que noto es que no hay problemas. Para que la gente se involucre, debes estar visible en su feed de noticias de GitHub. Cuando comience un problema, se mostrará a las personas que siguen el proyecto (no a los que lo protagonizaron). Entonces, el tamaño de su comunidad es en realidad de unos 80 seguidores. Solo debes pensar en los seguidores. Los tenedores pueden simplemente agarrar el código y alejarse, y las estrellas son como marcadores. Un seguidor será notificado de nuevos problemas.

Intenta abrir algunos problemas fáciles.

EDITAR:

Su archivo README.md es su anuncio para el repositorio. Es lo primero que leerán las personas, y lo primero a lo que recurrirán en busca de ayuda. 2/3 de su archivo léame habla de lo que es Hebel en un lenguaje técnicamente específico (es decir, no tengo idea de lo que está hablando). El 1/3 inferior tiene solo unas pocas instrucciones de instalación.

Una de las cosas más difíciles que he encontrado con GitHub es lograr que los proyectos realmente hagan lo que el autor afirma. Instalar, ejecutar y ponerse a trabajar lleva más tiempo. Si alguien obtiene su repositorio pero no puede hacerlo funcionar, nunca recibirá una solicitud de extracción.

Solo puedo sospechar que esta es la causa.

Revise su archivo Léame y coloque las instrucciones de inicio / instalación en la parte superior. Para que la gente pueda saltar y ponerse en marcha.

En segundo lugar, incluya algún tipo de muestra / ejemplo que puedan comenzar a ejecutar rápidamente que demuestre los beneficios del proyecto.


3
Sin duda. Si tiene una sección en el archivo README que se ve como "Contribuir: clone el repositorio, ejecute este script de compilación de una línea, agregue una función, agregue una prueba, envíe un PR", entonces creo que avanzará mucho. Hay toneladas de inercia saltando al proyecto de otra persona. ¡Haz que sea fácil para ellos!
Daniel J. Pritchett
Al usar nuestro sitio, usted reconoce que ha leído y comprende nuestra Política de Cookies y Política de Privacidad.
Licensed under cc by-sa 3.0 with attribution required.