# Contribuir

> Cómo contribuir con código y con la documentación — docs-as-code, Definition of Done y capturas automáticas.

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

# Contribuir

Cómo devolver al proyecto — con **código** y con la **propia documentación**.

## Documentación: docs-as-code
La documentación es **Markdown en el repositorio**, revisada por PR (como el código). Las convenciones de este sitio están en
`_BLUEPRINT.md` y en el README:
- **Diátaxis:** un **modo por página** (tutorial / how-to / explicación / referencia) — no los mezcles.
- **Fuente única:** cada hecho tiene un dueño; las demás páginas **enlazan** en vez de reexplicar.
- **Verifica en la fuente:** cuando haya divergencia, el **código** es la verdad (no el Javadoc); señala la divergencia.

## Definition of Done (cambio de API)
Toda modificación de API solo está "lista" cuando:
- [ ] la **página de referencia** correspondiente fue actualizada;
- [ ] los ejemplos afectados siguen **compilando** contra la API actual;
  glosario §35.1.

## Capturas que no quedan obsoletas
Las imágenes de la documentación se **generan automáticamente** de las pantallas de ejemplo vía `Main.getScreenShot(...)` + el
framework de pruebas ([Pruebas](/docs/best-practices/testes)) — con `DeviceConfig.isTesting = true` para
render determinista. Al cambiar una pantalla, regenera el golden en vez de adjuntar una captura manual.

## Código
Flujo estándar: **issue → PR → review**. Incluye pruebas (`dev.crossfly.test`) y mantén el
comportamiento single-thread de UI y el patrón `Thread` + `Component.onUI` para trabajo en segundo plano.

## Ver también
- [Comunidad y soporte](/docs/resources/community-and-support) · [Roadmap](/docs/resources/roadmap)