Esta hoja de referencia resume los pasos importantes que debes seguir para promover tu proyecto de código abierto en óptimas condiciones. Puedes hacer clic en los elementos para expandir y obtener más información de un tema.
Lista de lenguajes disponibles:
- العربية
- English
- Català
- Deutsch
- Español
- پارسی
- Français
- Bahasa Indonesia
- Italiano
- 日本語
- Português
- Русский
- සිංහල
- Türkçe
- 简体中文
- 繁體中文
¿Un lenguaje falta? ¿Deseas mejorar esta hoja? ¡Las contribuciones son bienvenidas!
👌 Asegúrate que tu proyecto sea lo suficientemente maduro
Tu proyecto debe ser lo suficientemente estable con las características mínimas viables con el fin de atraer a los usuarios.
😎 Escoge un nombre atractivo para tu proyecto
Escoge un nombre que los usuarios puedan recordar fácilmente.
💅 Haz que tu README sea elegante
El README es lo primero que verán tus visitantes. Hazlo simple, elegante y fácil de leer. Aquí hay una lista de ejemplos README.
💪 Destaca los puntos fuertes de tu proyecto
Identifica las fortalezas de tu proyecto y asegúrate de que los visitantes las vean primero.
✨ Proporciona una demostración de tu proyecto
Los visitantes desean comprender rápidamente el propósito de tu proyecto, cómo funciona y cómo usarlo. Proporciona una demostración es la mejor manera de complacer a los usuarios. Podría ser:
- Un GIF animado que demuestra cómo funciona tu proyecto
- Un enlace a una demostración
👌 Instalación/Manejo debe ser súper fácil
Probablemente perderás visitantes si tu proyecto no es fácil de usar.
📘 Crea una documentación limpia y bien estructurada
Crear una buena documentación es probablemente el paso más importante. Si tienes una pequeña documentación, puedes incluirla en tu archivo README. De lo contrario, probablemente deberías alojarlo en un sitio web por separado. Algunos proyectos de código abierto como vuepress pueden ayudarte a crear documentación limpia de una manera simple.
⭐ Haz que tu proyecto sea confiable antes de publicarlo en las redes sociales
La mayoría de los visitantes comprobarán cuántas estrellas tiene tu proyecto antes de considerar usarlo. Una cantidad mínima de estrellas hace que tu proyecto sea más confiable que un proyecto con cero estrellas. Es por eso que debes pedir a las personas que conoces que apoyen tu proyecto antes de hacer un anuncio público en las redes sociales.
↗️ Comparte tu proyecto en redes sociales y plataformas especializadas
¡Cuéntale al mundo de tu increíble trabajo! Publica en redes sociales y plataformas especializadas:
📃 Escribe artículos que mencionen tu proyecto
Escribe artículos sobre tu proyecto. El propósito puede ser el conjunto de tecnologías que utilizaste, cómo funciona tu proyecto, los problemas que encontraste, etc. Publica en plataformas como:
🎤 Presenta tu proyecto en conferencias/reuniones
Presentar tu proyecto en conferencias o reuniones es una buena manera de mejorar su visibilidad.
🎥 Graba y publica videos sobre tu proyecto, cómo funciona, etc.
Grabar un video no es una tarea fácil. Sin embargo, es probablemente la forma más eficiente de hacer notorio tu proyecto.
🕐 Elige el mejor momento para publicar en las redes sociales
No publiques durante el período de vacaciones o fines de semana. Por lo general, el mejor momento para publicar en las redes sociales es a mitad de semana.
🗑 No hagas spam en plataformas con tu mención
No publiques dos veces en la misma plataforma. Es considerado como spam y puede causar mala publicidad para tu proyecto.
🆕 Intenta lanzar regularmente nuevas versiones de tu proyecto
Realiza mantenimiento y mejora tu proyecto con nuevos lanzamientos y genera un registro de cambios.
❗ Manten tu proyecto, revisa los problemas pendientes
No dejes problemas pendientes sin respuesta. Sé amable con las personas que se tomaron el tiempo para dejar una sugerencia. 😉
🙏 Invita a otros usuarios a contribuir
Un proyecto saludable es un proyecto con una comunidad y contribuidores activos. Informa a tus usuarios que necesita ayuda etiquetando algunos problemas con las etiquetas de
contribution welcomeogood first issue. Ver más etiquetas de github.
🏆 Recompensas a los contribuidores
¡Sé amable con las personas que te ayudaron! Algunos proyectos de código abierto como gatsby premian a los contribuidores. Si no puedes pagar eso, haz una publicación (en twitter u otras plataformas) sobre la contribución y menciona al autor (este es un ejemplo de agradecimiento público). Abre una sección de
Contribuidoresen tu archivo README para agradecerles públicamente o mostrarlos en la documentación de tu proyecto o sitio web. Aquí hay unos ejemplos:
💬 Abre una plataforma de chat comunitario
Los problemas pendientes en Github no siempre son la mejor manera de comunicarte con tus usuarios. Si es necesario, puedes usar plataformas de chat para discutir con ellos.
🔙 Pide retroalimentación
Los comentarios de los usuarios son la mejor manera de mejorar tu proyecto. Probablemente tienen características e ideas que podrían mejorar tu proyecto.
❤️ Abre una galería de casos de uso para mostrar a los usuarios que utilizaron tu proyecto
Los visitantes confiarán en tu proyecto si ven casos de uso concretos e historias de éxito, por ejemplo, la gallería vuepress.
⭐️ a este repositorio ¡si esta hoja de referencia te ayudó!
Gracias a estas maravillosas personas:
Este projecto sigue la especificación all-contributors. ¡Las contribuciones de cualquier tipo son bienvenidas!