# Guia do contribuidor

{% hint style="info" %}
Movemos o rastreamento de issues do OnlyDust para **GrantFox**:\
<https://www.grantfox.xyz/>
{% endhint %}

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

{% stepper %}
{% step %}

### Fork, clone e sincronize

1. Faça um fork do repositório no GitHub.
2. Clone seu fork:

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

3. Adicione o remote upstream:

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

4. Sincronizar `develop`:

```sh
git checkout develop
git pull upstream develop
```

{% endstep %}

{% step %}

### Crie uma branch

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

Crie uma nova branch para cada mudança:

```sh
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`
  {% endstep %}

{% step %}

### 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.
  {% endstep %}

{% step %}

### 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:

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

{% endstep %}

{% step %}

### 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).
  {% endstep %}

{% step %}

### 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.
   {% endstep %}
   {% endstepper %}

### Link

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

{% columns %}
{% column %}

#### Tarefas & recompensas

[GrantFox](https://www.grantfox.xyz/)
{% endcolumn %}

{% column %}

#### Repositórios

[TrustlessWork no GitHub](https://github.com/TrustlessWork)
{% endcolumn %}

{% column %}

#### Comunidade

[Grupo no Telegram](https://t.me/+kmr8tGegxLU0NTA5)
{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
Se você estiver bloqueado, deixe uma mensagem curta no Telegram com o link do seu PR.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.trustlesswork.com/trustless-work/v1-pt/comunidade-e-contribuicao/get-involved.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.