:page_facing_up: Open source promotion cheat sheet
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

13KB

oss image

tweet

Hoja de referencia de promoción al código abierto

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:

¿Un lenguaje falta? ¿Deseas mejorar esta hoja? ¡Las contribuciones son bienvenidas!

1. 🎢 Pasos de preparación


👌 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.


2. 📢 Correr la voz sobre tu trabajo


⭐ 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.


3. 🤝 Conserva a tus usuarios


🆕 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 welcome o good 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 Contribuidores en 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.


🙏 Muestra tu apoyo

⭐️ a este repositorio ¡si esta hoja de referencia te ayudó!


❤️ Contribuidores

Gracias a estas maravillosas personas:

Franck Abgrall
Franck Abgrall

📖
Thomas Betous
Thomas Betous

📖
Eric Briand
Eric Briand

📖
Faustine Godbillot
Faustine Godbillot

📖
Benjamin Plouzennec
Benjamin Plouzennec

📖
Johan Bonneau
Johan Bonneau

📖
Benjamin Petetot
Benjamin Petetot

📖
NickHatBoecker
NickHatBoecker

🌍
Claire Martinez
Claire Martinez

🌍
André Gama
André Gama

📖
Mathias Bernardeau
Mathias Bernardeau

📖
Antoine Oili
Antoine Oili

📖
Oswld TC
Oswld TC

🌍
Zhiyue Yi
Zhiyue Yi

🌍

Este projecto sigue la especificación all-contributors. ¡Las contribuciones de cualquier tipo son bienvenidas!