# रेफ़रेंस कैसे व्यवस्थित है

> CrossFly संदर्भ के तीन स्तर, और हर API का एक ही आधिकारिक स्रोत रखने का नियम।

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

# रेफ़रेंस कैसे व्यवस्थित है

यह सेक्शन **परामर्श** के लिए है, सीखने के लिए नहीं। किसी अवधारणा को समझने के लिए,
[`concepts/`](/docs/concepts) पर जाएँ; किसी चरण-दर-चरण मार्गदर्शन के लिए, [`cookbook/`](/docs/cookbook)।

## रेफ़रेंस की तीन परतें
1. **तकनीकी अध्याय** (`../../` में 36 फ़ाइलें) — **आधिकारिक सत्य**,
   वर्तमान सोर्स कोड के विरुद्ध ऑडिट किया गया (2026 ऑडिट)। यहीं "API X के बारे में सच" रहता है।
2. **जनरेट किया गया Javadoc** (`gradle javadoc`) — **सटीक हस्ताक्षर**, हमेशा बिल्ड के साथ अद्यतन। किसी मेथड
   के सूक्ष्म विवरण के लिए इसका उपयोग करें।
3. **क्यूरेटेड पेज** (यह फ़ोल्डर) — जो बिखरा हुआ है उसे समेकित करते हैं और **तालिकाबद्ध** करते हैं:
   विजेट्स का कैटलॉग, `UIConstants` के enums, चीट शीट, शब्दावली।

## एकल-स्रोत नियम
हर तथ्य का **एक मालिक** होता है। यदि आपको वही जानकारी दो जगह मिलती है, तो मालिक **तकनीकी
अध्याय / Javadoc** है, और बाक़ी वहीं की ओर **लिंक** करता है (डुप्लिकेट नहीं करता)। यह ब्लूप्रिंट के
एंटी-डुप्लिकेशन नियम का अनुप्रयोग है।

## ⚠️ Javadoc × कोड: कोड पर भरोसा करें
CrossFly का Javadoc **कुछ बिंदुओं पर पुराना है** (2026 आधुनिकीकरण ने कई
APIs को स्थानांतरित/नाम बदल दिया)। **स्वर्ण नियम:** विरोधाभास होने पर, **सोर्स कोड और इस डॉक्युमेंटेशन पर भरोसा करें, अलग-थलग Javadoc
पर नहीं।** ज्ञात विरोधाभास प्रभावित पेजों पर चिह्नित हैं (उदा.: `AlphaAnimation` Javadoc में
`setAlpha` दिखाता है, लेकिन वास्तविक मेथड `alpha(float)` है)।

## जो चाहिए उसे कैसे ढूँढें
| आप चाहते हैं… | यहाँ जाएँ |
|---|---|
| किसी लेआउट के `add()` का हस्ताक्षर | [चीट शीट](/docs/reference/cheat-sheets) |
| किसी enum के मान (`RelPos`, `EditMode`…) | [Enums और `UIConstants`](/docs/reference/enums-uiconstants) |
| किसी विजेट के गुण | [विजेट्स का कैटलॉग](/docs/reference/widget-catalog) |
| किसी पैकेज/क्लास की API पर जाना | [API इंडेक्स](/docs/reference/api-reference) |
| किसी शब्द का अर्थ | [शब्दावली](/docs/reference/glossary) |