Guia do contribuidor

Movemos o rastreamento de issues do OnlyDust para GrantFox: https://www.grantfox.xyz/

Contribua para os repositórios Trustless Work com um fluxo de PR limpo.

Mantenha as alterações pequenas. Mantenha os commits claros. Direcione para develop.

Fluxo de trabalho

1

Fork, clone e sincronize

1. Faça um fork do repositório no GitHub.

2. Clone seu fork:

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

1. Adicione o remote upstream:

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

1. Sincronizar develop:

git checkout develop
git pull upstream develop

2

Crie uma branch

Use main para produção. Use develop para trabalho em andamento.

Crie uma nova branch para cada mudança:

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

Nomenclatura de branches

• Features: feat/nome-da-feature

• Correções: fix/descricao-do-bug

• Docs: docs/topico

• Refatorações: refactor/area

Exemplos:

• feat/escrow-ui

• fix/api-timeout

• docs/getting-started

• refactor/contracts-cleanup

3

Faça alterações

Diretrizes:

• Mantenha as alterações pequenas e atômicas.

• Certifique-se de que os testes passem (quando disponíveis).

• Siga as regras de lint/format já existentes no repositório.

4

Commit e push

Mensagens de commit

Formato:

type: descrição curta (<= 72 chars)

Exemplos:

• feat: adicionar sistema de aprovação de escrow

• fix: tratar timeout da API

• docs: atualizar README com instruções de configuração

Tipos comuns:

• feat: Nova funcionalidade

• fix: Correção de bug

• docs: Atualização de documentação

• refactor: Reestruturação de código

• style: Formatação de código (sem alterações de lógica)

• test: Adição ou atualização de testes

• build: Alterações no processo de build ou dependências

• ci: Alterações na configuração de CI/CD

• chore: Atualizações diversas

Push:

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

5

Abra um PR

Abra um Pull Request da sua branch para develop.

Inclua:

• O que mudou e por quê.

• Como você testou.

• Capturas de tela para mudanças na UI (se relevante).

6

Revisar e mesclar

Mantenedores irão revisar seu PR.

Se você receber feedback:

1. Envie commits de acompanhamento para a mesma branch.

2. Resolva as conversas.

3. Aguarde aprovação e mesclagem.

Link

Use estes para encontrar trabalho, navegar por repositórios e fazer perguntas.

Tarefas & recompensas

GrantFox

Repositórios

TrustlessWork no GitHub

Comunidade

Grupo no Telegram

Se você estiver bloqueado, deixe uma mensagem curta no Telegram com o link do seu PR.