यह पृष्ठ पुर्तगाली से मशीन-अनुवादित है और इसमें त्रुटियाँ हो सकती हैं। पुर्तगाली संस्करण प्रामाणिक है।
योगदान
प्रोजेक्ट को कैसे वापस दें — कोड के साथ और डॉक्यूमेंटेशन के साथ।
डॉक्यूमेंटेशन: docs-as-code
डॉक रिपॉज़िटरी में Markdown है, जिसकी समीक्षा PR द्वारा होती है (कोड की तरह)। इस साइट के नियम
_BLUEPRINT.md और README में हैं:
- Diátaxis: प्रति पेज एक मोड (tutorial / how-to / explanation / reference) — न मिलाएँ।
- एकल स्रोत: हर तथ्य का एक मालिक होता है; बाकी पेज दोबारा समझाने के बजाय लिंक करते हैं।
- स्रोत पर सत्यापित करें: मतभेद होने पर, कोड ही सत्य है (Javadoc नहीं); मतभेद को चिह्नित करें।
Definition of Done (API बदलाव)
कोई भी API बदलाव तभी “पूर्ण” होता है जब:
- संबंधित रेफ़रेंस पेज अपडेट किया गया हो;
- प्रभावित उदाहरण वर्तमान API के विरुद्ध कंपाइल होते रहें; ग्लॉसरी §35.1।
स्क्रीनशॉट जो पुराने नहीं होते
डॉक की छवियाँ उदाहरण-स्क्रीनों से Main.getScreenShot(...) + टेस्टिंग फ्रेमवर्क
(टेस्ट) के ज़रिए स्वचालित रूप से जनरेट होती हैं — निर्धारक रेंडर के लिए
DeviceConfig.isTesting = true के साथ। किसी स्क्रीन को बदलने पर, मैनुअल प्रिंट संलग्न करने के बजाय golden को दोबारा जनरेट करें।
कोड
मानक फ्लो: issue → PR → review। टेस्ट (dev.crossfly.test) शामिल करें और UI का single-thread
व्यवहार तथा बैकग्राउंड कार्य के लिए Thread + Component.onUI पैटर्न बनाए रखें।