Guía del contribuyente

¡Bienvenido a la comunidad de código abierto de Trustless Work! 🚀 Agradecemos tu interés en contribuir y ayudarnos a construir Infraestructura escrow para la Nueva Economía. Esta guía te guiará a través del proceso de contribuir de forma efectiva.

Si quieres contribuir y recibir una recompensa, postúlate a través de Only Dust. Only Dust facilita la vida de los mantenedores ya que gestiona las recompensas por nosotros. Puede que recibas (o puede que no :( ) una recompensa y no está en nuestras manos. Stellar patrocina las campañas de OD y las recompensas provienen de ellos. ¡Gracias Stellar!

Trustless Work en OnlyDust

Una vez asignada una tarea, por favor sigue estas pautas:

---

🔹 1. Primeros pasos

Fork y clona el repositorio

1. Fork el repositorio en GitHub.

2. Clona tu repositorio forked en tu máquina local:

   git clone https://github.com/YOUR_USERNAME/REPOSITORY_NAME.git
   cd REPOSITORY_NAME

3. Configura el remoto upstream para sincronizar con el repositorio principal:

   git remote add upstream https://github.com/TrustlessWork/REPOSITORY_NAME.git

4. Asegúrate de estar en la versión más reciente de develop:

   git checkout develop
   git pull upstream develop

---

🔹 2. Estrategia de ramas

Seguimos un modelo de branching estructurado para mantener las contribuciones organizadas.

Ramas principales

• main → La lista para producción branch (NO hagas push aquí directamente).

• develop → La desarrollo activo branch donde se fusionan las características.

Ramas de features y fixes

Crea una rama según el tipo de cambio:

• Características: feat/nombre-de-feature

  • Ejemplo: feat/escrow-ui

• Correcciones de errores: fix/descripción-del-bug

  • Ejemplo: fix/api-response-error

• Documentación: docs/actualizar-nombre

  • Ejemplo: docs/guía-de-primeros-pasos

• Refactorización: refactor/mejora-de-código

  • Ejemplo: refactor/limpiar-contratos-inteligentes

Crea una nueva rama

Siempre crea una nueva rama antes de hacer cambios:

   git checkout develop
   git pull upstream develop  # Sincroniza con el código más reciente
   git checkout -b feat/new-feature

---

🔹 3. Realización de contribuciones

Estándares de codificación

✅ Mantén los cambios pequeños y atómicos. ✅ Sigue las directrices de mensajes de commit (ver más abajo). ✅ Asegúrate de que las pruebas pasen antes de enviar un PR. ✅ Formatea el código usando nuestras reglas de linting y formateo.

Directrices de mensajes de commit

Usa un mensaje de commit claro y conciso con el formato:

tipo: descripción corta (menos de 72 caracteres)

Ejemplos:

• feat: agregar sistema de aprobación escrow

• fix: resolver problema de timeout de la API

• docs: actualizar README con instrucciones de configuración

Tipos:

• feat: Nueva característica

• fix: Corrección de bug

• docs: Actualización de documentación

• refactor: Reestructuración de código

• style: Formateo de código (sin cambios de lógica)

• test: Agregar o actualizar pruebas

• build: Cambios en el proceso de build o dependencias

• ci: Cambios en la configuración de CI/CD

• chore: Actualizaciones misceláneas

---

🔹 4. Enviar cambios y crear un PR

Sube tus cambios

   git add .
   git commit -m "feat: add escrow approval system"
   git push origin feat/new-feature

Crea un Pull Request (PR)

1. Ve al repositorio original en GitHub.

2. Haga clic Nuevo Pull Request.

3. Seleccionar develop como la rama base y tu rama de feature como la rama de comparación.

4. Proporciona una descripción clara de los cambios.

5. ¡Envíalo para revisión!

---

🔹 5. Revisión de código y proceso de fusión

✅ Los mantenedores revisarán el PR y proporcionarán comentarios. ✅ Si se solicita, realiza cambios y sube actualizaciones a tu PR. ✅ Una vez aprobado, el PR se fusiona en develop. ✅ Después de las pruebas, develop se fusiona en main para producción.

---

🔹 6. Recursos adicionales

📖 Trustless Work GitHub – Navega por nuestros repositorios. 💬 Únete a nuestro Telegram – Conéctate con otros contribuidores.

¡Feliz codificación! 🎉