Jak mogę dodać kod do Joomla?

19

Wiem, że kodem zarządza się na https://github.com/joomla/joomla-cms (przynajmniej dla CMS) i że powinienem przesyłać żądania ściągania, aby zasugerować dodanie kodu.

Jestem szczególnie zainteresowany wszelkimi dobrymi wskazówkami na temat zarządzania moimi wkładami i upewnienia się, że kod trafia we właściwe miejsce.

Czy powinienem używać różnych gałęzi w moim rozwidlonym repozytorium do zarządzania różnymi wkładami? Jeśli tak, to jak najlepiej połączyć tę gałąź z głównymi gałęziami w repozytorium Joomla?

Czy istnieje dobry sposób na aktualizowanie mojej rozwidlonej kopii?

Wszelkie sugestie dotyczące dobrego przepływu zarządzania tym procesem byłyby naprawdę pomocne!

David Fritsch
źródło

Odpowiedzi:

10

Zawsze dobrze jest mieć dedykowany oddział dla każdego Żądania Pull, które zamierzasz złożyć.

Jednym z najprostszych sposobów utworzenia aktualnego nowego oddziału jest użycie GUI sieci GitHub do edycji pliku w oryginalnym repozytorium. Podczas zapisywania GitHub automatycznie utworzy w gałęzi nowy oddział na podstawie gałęzi, którą aktualnie edytujesz. Jeśli chcesz edytować więcej plików, możesz je edytować w nowo utworzonym i aktualnym oddziale.

Jeśli jesteś trochę zaznajomiony z Gitem, wówczas podstawisz rozwidloną gałąź pomostową za pomocą oryginalnej gałęzi początkowej, aby była zsynchronizowana przed utworzeniem nowych gałęzi. Również jeśli musisz zaktualizować PR, zaleca się jego zmianę bazy zamiast scalania wzorca. Podczas gdy oba sposoby działają, scalanie-zatwierdzanie po prostu tworzy złą historię i trudniej jest je zgnieść.

Ogólnie rzecz biorąc, PR powinny być „atomowe”. Oznacza to, że jeśli spróbujesz coś naprawić, napraw tylko ten konkretny błąd. Nie naprawiaj dwóch różnych błędów w tym samym PR, a także nie poprawiaj stylu kodowania. Łatwiej jest przetestować, a także rzadziej wywoływać konflikty, jeśli PR żyje nieco dłużej niż oczekiwano.

I oczywiście dodaj dobry opis tego, co chcesz zrobić, oraz instrukcje testowania w celu odtworzenia problemu i przetestowania poprawki :-)

Bakual
źródło
4

Jedną wielką rzeczą, która pomaga w grupowaniu składek, jest przeniesienie każdego wkładu do osobnego, odpowiednio nazwanego oddziału. Jeśli dodajesz funkcję, użyj prefiksu, takiego jak, feature-i dodaj jedno lub dwa słowa opis funkcji dla nazwy oddziału. Jeśli to poprawka błędu w JFormklasie, użyj bugfix-jform. Dzięki temu naprawdę łatwo jest zidentyfikować, nad czym pracujesz, sprawdzając swoje gałęzie git za pośrednictwem git branch -a.

Don Gilbert
źródło