मैं जूमला में कोड का योगदान कैसे करूं?

Question

मुझे पता है कि कोड https://github.com/joomla/joomla-cms (CMS के लिए कम से कम) में प्रबंधित है और मुझे उस कोड को जोड़ने का सुझाव देने के लिए पुल अनुरोध प्रस्तुत करना चाहिए।

मैं अपने योगदान को प्रबंधित करने और कोड को सही स्थान पर लाने के लिए सुनिश्चित करने के बारे में किसी भी अच्छे सुझावों में विशेष रूप से दिलचस्पी रखता हूं।

क्या मुझे अलग-अलग योगदानों का प्रबंधन करने के लिए अपने फोर्क्ड रेपो में विभिन्न शाखाओं का उपयोग करना चाहिए? यदि हां, तो उस शाखा को जूमला रेपो में मुख्य शाखाओं से जोड़ने का सबसे अच्छा तरीका क्या है?

क्या मेरे कांटे की नकल को अद्यतित रखने की एक अच्छी विधि है?

इस प्रक्रिया के प्रबंधन के लिए एक अच्छा प्रवाह पर कोई सुझाव वास्तव में उपयोगी होगा!

Answer 1

आपके द्वारा किए जाने वाले प्रत्येक पुल अनुरोध के लिए एक समर्पित शाखा होना हमेशा अच्छा होता है।

अप-टू-डेट नई शाखा बनाने के सबसे सरल तरीकों में से एक है कि मूल रिपॉजिटरी में फ़ाइल को संपादित करने के लिए सिर्फ GitHub web gui का उपयोग करें। बचत करते समय, GitHub आपके द्वारा वर्तमान में संपादित की गई शाखा के आधार पर आपके कांटे में एक नई शाखा बनाएगा। यदि आप अधिक फ़ाइलों को संपादित करना चाहते हैं, तो आप उन्हें अपनी नई बनाई गई और अद्यतित शाखा में संपादित कर सकते हैं।

यदि आप Git से थोड़े परिचित हैं, तो आप अपनी forked मंचन शाखा को अपस्ट्रीम मूल शाखा से रिबेट करते हैं, इसलिए नई शाखाएँ बनाने से पहले यह सिंक में है। इसके अलावा, अगर आपको पीआर अपडेट करना है, तो इसे मर्ज करने के बजाय इसे फिर से बनाने की सिफारिश की जाती है। हालांकि दोनों तरह से काम करते हैं, मर्ज-कमिट केवल खराब इतिहास बना रहे हैं और स्क्वैश के लिए कठिन हैं।

आम तौर पर, पीआर को "परमाणु" होना चाहिए। इसका मतलब है कि यदि आप कुछ ठीक करने की कोशिश करते हैं, तो केवल उस विशेष बग को ठीक करें। एक ही पीआर में दो अलग-अलग बग को ठीक न करें और कोडस्टिक्स फिक्स भी न करें। यह परीक्षण करना आसान है और यदि पीआर उम्मीद से थोड़ा अधिक समय तक रहता है, तो संघर्ष की संभावना कम है।

और निश्चित रूप से इस बात का एक अच्छा विवरण जोड़ें कि आप क्या करना चाहते हैं और इस मुद्दे को पुन: पेश करने के लिए निर्देशों का परीक्षण करें और अपने फिक्स का परीक्षण करें :-)

Answer 2

आपके योगदान को समूहीकृत करने में मदद करने वाली एक बड़ी बात यह है कि प्रत्येक योगदान को एक अलग, उचित रूप से नामित शाखा में स्थानांतरित किया जाए। यदि आप एक सुविधा जोड़ रहे हैं, तो उपसर्ग का उपयोग करें feature-और शाखा नाम के लिए एक या दो शब्द सुविधा वर्णन जोड़ें। यदि यह JFormवर्ग में बग फिक्स है , तो उपयोग करें bugfix-jform। यह वास्तव में यह पहचानना आसान बनाता है कि आप अपनी git शाखाओं की जाँच करके क्या काम कर रहे हैं git branch -a।