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

यह सेक्शन परामर्श के लिए है, सीखने के लिए नहीं। किसी अवधारणा को समझने के लिए, concepts/ पर जाएँ; किसी चरण-दर-चरण मार्गदर्शन के लिए, 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) है)।

जो चाहिए उसे कैसे ढूँढें