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) — 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
Esta página foi útil?Obrigado pelo feedback!