# Contribuindo

> Como contribuir com código e com a doc — docs-as-code, Definition of Done e screenshots automáticas.

Source: https://crossfly.dev/pt/docs/resources/contributing — CrossFly documentation. Full docs as one file: https://crossfly.dev/llms-full.txt

# Contribuindo

Como devolver ao projeto — com **código** e com a **própria documentação**.

## Documentação: docs-as-code
A doc é **Markdown no repositório**, revisada por PR (como o código). As convenções deste site estão no
`_BLUEPRINT.md` e no README:
- **Diátaxis:** um **modo por página** (tutorial / how-to / explicação / referência) — não misture.
- **Fonte única:** cada fato tem um dono; as demais páginas **linkam** em vez de reexplicar.
- **Verifique na fonte:** ao divergir, o **código** é a verdade (não o Javadoc); sinalize a divergência.

## Definition of Done (mudança de API)
Toda alteração de API só está "pronta" quando:
- [ ] a **página de referência** correspondente foi atualizada;
- [ ] exemplos afetados continuam **compilando** contra a API atual;
  glossário §35.1.

## Screenshots que não envelhecem
As imagens da doc são **geradas automaticamente** das telas de exemplo via `Main.getScreenShot(...)` + o
framework de testes ([Testes](/docs/best-practices/testes)) — com `DeviceConfig.isTesting = true` para
render determinístico. Ao mudar uma tela, regenere o golden em vez de anexar um print manual.

## Código
Fluxo padrão: **issue → PR → review**. Inclua testes (`dev.crossfly.test`) e mantenha o
comportamento single-thread de UI e o padrão `Thread` + `Component.onUI` para trabalho de fundo.

## Veja também
- [Comunidade e suporte](/docs/resources/community-and-support) · [Roadmap](/docs/resources/roadmap)