# Cómo se organiza la referencia

> Las tres capas de la referencia de CrossFly y la regla de fuente única.

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

# Cómo se organiza la referencia

Esta sección es para **consultar**, no para aprender. Para entender un concepto, ve a
[`concepts/`](/docs/concepts); para seguir un paso a paso, [`cookbook/`](/docs/cookbook).

## Las tres capas de la referencia
1. **Capítulos técnicos** (los 36 archivos en `../../`) — la **verdad canónica**,
   auditada contra el código fuente actual (auditoría 2026). Es donde vive "la verdad sobre la API X".
2. **Javadoc generado** (`gradle javadoc`) — las **firmas exactas**, siempre al día con el build. Úsalo
   para el detalle granular de un método.
3. **Páginas curadas** (esta carpeta) — consolidan y **tabulan** lo que está disperso: catálogo de
   widgets, enums de `UIConstants`, hojas de referencia rápida, glosario.

## Regla de fuente única
Cada hecho tiene **un dueño**. Si encuentras la misma información en dos lugares, el dueño es el **capítulo
técnico / Javadoc**, y el resto **enlaza** hacia allí (no duplica). Es la aplicación de la regla anti-duplicación
del blueprint.

## ⚠️ Javadoc × código: confía en el código
El Javadoc de CrossFly está **desactualizado en algunos puntos** (la modernización 2026 movió/renombró varias
APIs). **Regla de oro:** al divergir, **confía en el código fuente y en esta documentación, no en el Javadoc
aislado.** Las divergencias conocidas están señaladas en las páginas afectadas (ej.: `AlphaAnimation` muestra
`setAlpha` en el Javadoc, pero el método real es `alpha(float)`).

## Cómo encontrar lo que necesitas
| Quieres… | Ve a |
|---|---|
| la firma de `add()` de un layout | [Hojas de referencia rápida](/docs/reference/cheat-sheets) |
| los valores de un enum (`RelPos`, `EditMode`…) | [Enums y `UIConstants`](/docs/reference/enums-uiconstants) |
| las propiedades de un widget | [Catálogo de widgets](/docs/reference/widget-catalog) |
| ir a la API de un paquete/clase | [Índice de API](/docs/reference/api-reference) |
| el significado de un término | [Glosario](/docs/reference/glossary) |