# Como a referência é organizada

> As três camadas da referência do CrossFly e a regra de fonte única.

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

# Como a referência é organizada

Esta seção é para **consultar**, não para aprender. Para entender um conceito, vá para
[`concepts/`](/docs/concepts); para seguir um passo a passo, [`cookbook/`](/docs/cookbook).

## As três camadas da referência
1. **Capítulos técnicos** (os 36 arquivos em `../../`) — a **verdade canônica**,
   auditada contra o código-fonte atual (auditoria 2026). É onde mora "a verdade sobre a API X".
2. **Javadoc gerado** (`gradle javadoc`) — as **assinaturas exatas**, sempre em dia com o build. Use
   para o detalhe granular de um método.
3. **Páginas curadas** (esta pasta) — consolidam e **tabelam** o que está espalhado: catálogo de
   widgets, enums de `UIConstants`, folhas de cola, glossário.

## Regra de fonte única
Cada fato tem **um dono**. Se você encontrar a mesma informação em dois lugares, o dono é o **capítulo
técnico / Javadoc**, e o resto **linka** para lá (não duplica). É a aplicação da regra anti-duplicação
do blueprint.

## ⚠️ Javadoc × código: confie no código
O Javadoc do CrossFly está **desatualizado em pontos** (a modernização 2026 moveu/renomeou várias
APIs). **Regra de ouro:** ao divergir, **confie no código-fonte e nesta documentação, não no Javadoc
isolado.** Divergências conhecidas estão sinalizadas nas páginas afetadas (ex.: `AlphaAnimation` mostra
`setAlpha` no Javadoc, mas o método real é `alpha(float)`).

## Como achar o que precisa
| Você quer… | Vá para |
|---|---|
| a assinatura de `add()` de um layout | [Folhas de cola](/docs/reference/cheat-sheets) |
| os valores de um enum (`RelPos`, `EditMode`…) | [Enums e `UIConstants`](/docs/reference/enums-uiconstants) |
| as propriedades de um widget | [Catálogo de widgets](/docs/reference/widget-catalog) |
| ir para a API de um pacote/classe | [Índice de API](/docs/reference/api-reference) |
| o significado de um termo | [Glossário](/docs/reference/glossary) |