Guía del contribuidor

Movimos el seguimiento de incidencias de OnlyDust a GrantFox: https://www.grantfox.xyz/

Contribuye a los repositorios de Trustless Work con un flujo de PR limpio.

Mantén los cambios pequeños. Mantén los commits claros. Apunta a develop.

Flujo de trabajo

1

Bifurcar, clonar y sincronizar

1. Bifurca el repo en GitHub.

2. Clona tu fork:

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

1. Agrega el remote upstream:

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

1. Sincronizar develop:

git checkout develop
git pull upstream develop

2

Crear una rama

Usa main para producción. Usa develop para trabajo en curso.

Crea una nueva rama para cada cambio:

git checkout develop
git pull upstream develop
git checkout -b feat/new-feature

Nomenclatura de ramas

• Características: feat/nombre-de-la-característica

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

• Documentación: docs/tema

• Refactorizaciones: refactor/área

Ejemplos:

• feat/escrow-ui

• fix/api-timeout

• docs/introducción

• refactor/limpieza-de-contratos

3

Realiza cambios

Pautas:

• Mantén los cambios pequeños y atómicos.

• Asegúrate de que las pruebas pasen (cuando estén disponibles).

• Sigue las reglas de lint/formato existentes en el repo.

4

Commit y push

Mensajes de commit

Formato:

tipo: breve descripción (<= 72 caracteres)

Ejemplos:

• feat: agregar sistema de aprobación escrow

• fix: manejar tiempo de espera de la API

• docs: actualizar README con instrucciones de configuración

Tipos comunes:

• feat: Nueva característica

• fix: Corrección de bug

• docs: Actualización de documentación

• refactor: Reestructuración de código

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

• test: Añadir 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

Push:

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

5

Abrir un PR

Abre un Pull Request desde tu rama hacia develop.

Incluye:

• Qué cambió y por qué.

• Cómo lo probaste.

• Capturas de pantalla para cambios en la UI (si procede).

6

Revisión y merge

Los mantenedores revisarán tu PR.

Si recibes comentarios:

1. Haz push de commits de seguimiento a la misma rama.

2. Resuelve las conversaciones.

3. Espera la aprobación y el merge.

Enlace

Usa estos para encontrar trabajo, explorar repos y hacer preguntas.

Tareas y recompensas

GrantFox

Repositorios

TrustlessWork en GitHub

Comunidad

Grupo de Telegram

Si estás bloqueado, deja un mensaje corto en Telegram con el enlace a tu PR.