Contribuye a este Proyecto

April 15, 2026 · View on GitHub

image info

Logo creado con :sparkling_heart: por CandidDeer

Tweet

Discord PRs Welcome Open Source Love

Anuncio:

¿Te gustaría convertirte en mantenedor de este proyecto? Lee la guía para mantenedores, únete a nuestro servidor de Discord y solicita unirte al equipo.

Índice de acceso rápido

Introducción

Esta es la versión del tutorial para terminal. Todo aquí usa Git por línea de comandos. Si prefieres una interfaz gráfica, usa GitHub Desktop.

¿Para quién es esto?

Para cualquier persona lo bastante cómoda con terminal como para ejecutar comandos básicos de Git. No necesitas ser experto: si puedes moverte entre carpetas y correr comandos, ya puedes hacerlo.

¿Con qué voy a contribuir?

Agregarás una tarjeta personal en la página del proyecto. Incluirá tu nombre, enlaces de contacto, una descripción corta y enlaces a recursos para desarrolladores que recomiendes.

Traducciones

Este tutorial también está disponible en otros idiomas. Ten en cuenta que las traducciones pueden ir un poco atrasadas frente a la versión en inglés.

BengalíAlemánHindiCoreanoChino (Tradicional)
Portugués (BR)EspañolTeluguUcraniano

Las traducciones de este tutorial son bienvenidas. Revisa CONTRIBUTING.md para empezar.

Preparación

Asegúrate de tener Git instalado:

git --version

Si no lo tienes, descarga Git aquí.

Contribuir

Conviértete en contribuyente de código abierto en 10 pasos.

Paso 1: Haz fork de este repositorio

Haz fork de este proyecto haciendo clic en el botón Fork arriba a la derecha en la página del repositorio. Esto crea una copia del proyecto en tu cuenta de GitHub.

↑ Ir arriba ↑

Paso 2: Clona el repositorio

Clona tu fork en tu máquina local:

git clone https://github.com/tu-usuario-github/Contribute-To-This-Project.git

Luego entra al directorio del proyecto:

cd Contribute-To-This-Project

↑ Ir arriba ↑

Paso 3: Crea una nueva rama

Crea y cambia a una rama nueva:

git checkout -b tu-nombre-card

Usa un nombre descriptivo. tu-nombre-card es una buena convención para este proyecto.

NO trabajes en la rama master.

↑ Ir arriba ↑

Paso 4: Copia el archivo plantilla

El proyecto tiene una plantilla de tarjeta lista en la carpeta cards/. Cópiala y renombra la copia con tu nombre de usuario exacto de GitHub:

cp cards/template.html cards/tu-usuario-github.html

Por ejemplo, si tu usuario es octocat:

cp cards/template.html cards/octocat.html

Este es el único archivo que vas a editar. No edites cards/template.html.

↑ Ir arriba ↑

Paso 5: Completa tu tarjeta

Abre tu archivo de tarjeta en el editor que prefieras:

code cards/tu-usuario-github.html   # VS Code
# o: nano, vim, etc.

Tu tarjeta se ve así:

<div class="card">
  <p class="name">Your name</p>
  <p class="contact">
    <!-- Add one or more contact links. At minimum, include your GitHub. -->
    <i class="fab fa-github"></i>
    <a href="https://www.github.com/your_user_handle" target="_blank">Your handle</a>
  </p>
  <p class="about">Write a sentence or two about yourself.</p>
  <div class="resources">
    <p>3 Useful Dev Resources</p>
    <ul>
      <li>
        <a href="#" target="_blank" title="First Resource">Resource 1</a>
      </li>
      <li>
        <a href="#" target="_blank" title="Second Resource">Resource 2</a>
      </li>
      <li>
        <a href="#" target="_blank" title="Third Resource">Resource 3</a>
      </li>
    </ul>
  </div>
</div>

Complétala así:

  • Nombre: reemplaza Your name por tu nombre. No cambies class="name".
  • Contacto: reemplaza el enlace y usuario de GitHub por los tuyos. Puedes agregar más contactos. Busca clases de iconos en Font Awesome Icons (ej. fab fa-linkedin, fab fa-x-twitter).
  • About: reemplaza el texto de ejemplo con una descripción corta sobre ti.
  • Recursos: reemplaza # con URLs reales, actualiza title="" y el texto de cada enlace. Son opcionales, pero si los incluyes, cada uno debe tener enlace real. Máximo 5.

No cambies nombres de clases ni la estructura del HTML. El bot de validación revisa eso.

Guarda el archivo cuando termines.

↑ Ir arriba ↑

Paso 6: Revisa tu trabajo

Abre tu archivo de tarjeta y revisa que:

  • Ya no haya texto de plantilla
  • Todos los enlaces empiecen con https://
  • El nombre del archivo coincida exactamente con tu usuario de GitHub

La validación automática al enviar el PR detectará cualquier problema estructural que se te haya escapado.

↑ Ir arriba ↑

Paso 7: Haz commit de tus cambios

Agrega tu archivo de tarjeta:

git add cards/tu-usuario-github.html

Haz commit con un mensaje corto:

git commit -m "Add my card"

↑ Ir arriba ↑

Paso 8: Sube tus cambios a GitHub

Haz push de tu rama a tu fork:

git push origin tu-nombre-card

↑ Ir arriba ↑

Paso 9: Envía un PR (Pull Request)

Ve a tu fork en GitHub. Verás un mensaje para abrir un pull request de la rama que acabas de subir. Haz clic en Compare & pull request.

Asegúrate de que el repositorio base sea Syknapse/Contribute-To-This-Project y la rama base sea master.

Deja activada la opción Allow edits from maintainers y luego haz clic en Create pull request.

Un bot validará tu tarjeta automáticamente. Si todo está bien, la fusiona solo. Si hay algo que corregir, el bot dejará un comentario explicando exactamente qué cambiar. Haz push del arreglo a la misma rama y se vuelve a validar.

↑ Ir arriba ↑

Paso 10: Celebra

Ya hiciste tu primera contribución open source. Tu tarjeta aparecerá en https://syknapse.github.io/Contribute-To-This-Project poco después del merge.

¿Dónde quedó mi archivo HTML? Después de un tiempo, las tarjetas enviadas se archivan automáticamente para mantener el repositorio liviano. Tu archivo se elimina de cards/, pero sus datos se conservan en el archivo y tu tarjeta sigue apareciendo en el sitio. Más información.

Siguientes pasos

  • También puedes aprender a contribuir con esta serie gratuita: How to Contribute to an Open Source Project on GitHub
  • Si este proyecto te fue útil, deja una :star: estrella :star: y comparte en X Tweet
  • Únete a nuestro servidor de Discord
  • ¿Quieres contribuir más allá de tu tarjeta? Revisa CONTRIBUTING.md para la guía completa.
  • Gracias por contribuir! Ahora puedes probar contribuir en otros proyectos. Busca la etiqueta Good First Issue para opciones amigables para principiantes.

Agradecimientos

Este proyecto está fuertemente influenciado por el gran proyecto first-contributions de Roshan Jossey.

Top 100 Contributors

GitHub Contributors Image